Skip to main content
GET
Get one usage event

Authorizations

Authorization
string
header
required

API key passed as a Bearer token in the Authorization header.

Headers

x-api-version
enum<string>
default:2025-11-01
required

API version to use. This endpoint currently requires 2025-11-01. Requests without the header, or with any other value, return 400.

Available options:
2025-11-01
Example:

"2025-11-01"

Path Parameters

request_id
string
required

The X-Request-Id response header of the request, also returned as event_id by GET /account/usage/events.

Maximum string length: 256

Response

The event, with the stored request.

An event plus the request that was stored for it.

event_id
string
required

The request id, the same value as the X-Request-Id header on the original response.

Example:

"678a3646-371d-4f81-b5c3-488fdda81e21"

ts
string
required

When the request was made, ISO 8601 in UTC with a +00:00 offset.

Example:

"2026-09-24T03:24:40.229000+00:00"

team_id
integer
required

Your team's id.

Example:

1318

user_id
integer
required

The user on your team who made the request.

Example:

1318

api_key_id
integer | null
required

The API key that made the request. null when the request is not tied to a key, such as a watch run or a request refused with a 429.

Example:

170

client_surface
string
required

Where the request came from. Values seen today are api, mcp, cli, dashboard, batch, watcher, export, and gateway for a request refused before it reached the API, such as a 429.

Example:

"api"

client_platform
string
required

The client detected from the request, for example python, node, curl or claude-code. It comes from the MCP client tag, the CLI's user agent, or a category based on your User-Agent header. New values can appear at any time. Empty for batch jobs, watches and exports, and usually for requests refused with a 429.

Example:

"curl"

user_agent
string
required

The User-Agent header you sent.

Example:

"curl/8.7.1"

client_ip
string
required

The IP address the request came from.

Example:

"203.0.113.10"

product
string
required

The product the request belongs to, for example person_enrich.

Example:

"person_enrich"

endpoint
string
required

The endpoint, as a route template when it has path parameters, for example /watch/person/:watch_id/runs. The actual values are in request.path_params on the single-event endpoint.

Example:

"/person/enrich"

method
string
required

The HTTP method.

Example:

"POST"

api_version
string
required

The x-api-version header you sent.

Example:

"2025-11-01"

http_status
integer
required

The status code returned.

Example:

200

status_class
string
required

2xx, 3xx, 4xx or 5xx.

Example:

"2xx"

error_type
string
required

The error.type returned on a failure, for example invalid_request. Empty on a success.

Example:

""

error_key
string
required

The error group the request belongs to in GET /account/usage/errors. Empty on a success and on a 429.

Example:

""

result_count
integer | null
required

Results the request returned.

Example:

1

latency_ms
number
required

Time the request took on the server, in milliseconds.

Example:

413.39

credits_used
number
required

Credits charged, the same number the original response returned in X-Credits-Used.

Example:

2

cost_components
object[]
required

The charge lines. Their credits add up to credits_used, and lines charged at 0 credits are kept. Empty when nothing was charged.

linked_ids
object
required

Ids of the job that made the request, when there is one, such as batch_job_id, watch_id, export_id and export_run_id. Empty for a direct API call.

Example:
request
object | null
required

What was sent. null when the stored copy is no longer available.

headers
object | null
required

The request headers, with authorization and apikey shown as <redacted>.

response
any | null
required

The error body a failed request got back, redacted. JSON when it was JSON, a string when it was not or was cut at 32 KB. null on a success and on a 429.