API Referencetraces

Fetch cost traces for an organization

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

limitintegerOptional1-1000Defaults to 100

Maximum number of traces to return (1-1000)

offsetintegerOptional>=0Defaults to 0
Number of traces to skip for pagination
startTimestringOptionalformat: "date-time"

Filter traces starting from this time (ISO 8601 format)

endTimestringOptionalformat: "date-time"

Filter traces up to this time (ISO 8601 format)

externalCustomerIdstringOptional
Filter traces by external customer ID
externalProductIdstringOptional
Filter traces by external product ID
externalAgentIdstringOptionalDeprecated

DEPRECATED: Use externalProductId instead. Filter traces by external agent ID

metadatastringOptional

Filter traces by metadata fields. Must be a valid JSON object (e.g., {“key1”:“value1”,“key2”:“value2”}). All specified fields must match (AND logic).

Response

Success response
traceslist of objects
metaobject
Pagination metadata for cost traces

Errors