Skip to content
Sign in Waitlist

Request log

GET /v1/usage/log scope read

Request log, newest first, kept for 30 days; metadata only (method, route without ids, status, duration, key), never bodies, headers or query strings. Filters: key (id or session), status (2xx, 3xx, 4xx, 5xx or a code), route (substring), method, days (1 to 30); limit (1 to 200, default 50) and cursor (the next of the previous page).

HeadersAuthorization: Bearer praeko_… and X-Praeko-Contract: en. Always send both.

Parameters

Name In Description
key query Id of a key or session (the dashboard).
status query 2xx, 3xx, 4xx, 5xx or a code.
route query Part of the route.
method query HTTP method.
days query How many days to look back (1 to 30).
limit query Items per page (1 to 200). Default: 50.
cursor query The next value of the previous page.

Example

curl "https://praeko.app/v1/usage/log" \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en"

Response

Success status When
200 Success.
Response 200
{
  "records": [
    {
      "id": "01KA3Z5Q8R2WJ7CX4DN9VB6T1H",
      "method": "POST",
      "route": "/v1/posts",
      "status": 201,
      "durationMs": 212,
      "key": "01KA3Y1B9E5MK7PR3XD0V4SN2G",
      "keyName": "script automation",
      "createdAt": "2026-11-07T14:02:11.482Z"
    }
  ],
  "next": "01KA3Z5Q8R2WJ7CX4DN9VB6T1H"
}

Metadata only (method, route without ids, status, duration, key); never body, headers or IP. Kept for 30 days. Pass next as cursor to get the next page; null on the last page.

Errors

No errors specific to this route besides the common ones.

Errors on any route

Status code When
401 unauthorized The Authorization: Bearer … header is missing.
401 invalid_api_key The key does not exist.
401 revoked_api_key The key has been revoked.
401 expired_api_key The key has expired.
403 forbidden The key's scope is not enough for this route (see the scope badge).
429 rate_limited The per-minute request limit was exceeded.

The body of every error is { "error": { "code", "message", "details"? } }. See all error codes.

Try it

Try it

The live test uses your key and your account. It stays off when you are not signed in.

Sign in to try it
Question or mistake on this page? contato@praeko.appView .md

Type to search pages, routes and error codes.