Usage event log

Per-request log, newest first. Filters are AND-ed: status accepts "success" (2xx), "error" (everything else) or an exact code, and from/to are inclusive UTC dates.

Authorization

BearerAuth

AuthorizationBearer <token>

Clerk session token (dashboard/management routes). In local dev mode use the X-Dev-User header instead.

In: header

Query Parameters

limit?integer

Range1 <= value <= 100

Default25

cursor?string

provider?string

keyId?string

status?string

Match^(success|error|[1-5]\d{2})$

from?string

Match^\d{4}-\d{2}-\d{2}$

to?string

Match^\d{4}-\d{2}-\d{2}$

Response Body

`application/json`

curl -X GET "https://example.com/manage/usage/events"

{  "items": [    {      "id": "string",      "provider": "string",      "endpoint": "string",      "method": "string",      "status": 200,      "credits": 0,      "latencyMs": 0,      "keyPrefix": "ext_live_a1b",      "createdAt": "2019-08-24T14:15:22Z",      "errorCode": "upstream_error"    }  ],  "nextCursor": "string"}

{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked."  }}

Authorization

Query Parameters

Response Body

200application/json

401application/json

`application/json`

`application/json`