Attribution Data API
List unique workflow IDs
Returns distinct workflow_id values from usage event metadata for the given date range, sorted alphabetically. Call it with a GET request to /attribution-data/workflows, authenticated with a restricted API key and the "costs:read" scope.
Returns distinct workflow_id values from usage event metadata for the given date range, sorted alphabetically. Useful for populating workflow filter dropdowns. The response is not paginated and is capped at 1000 values; `truncated` is `true` when that cap was reached. Convenience shortcut for GET /attribution-data/dimension-values with dimension=workflow_id. Requests count toward your per-API-key rate limit; sustained overruns return 429 with the standard error envelope.
Authentication and scopes
Authenticate with a restricted API key in the Authorization: Bearer <key> header. This endpoint requires the costs:read scope.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
start_date | query | string | Yes | Start of date range (ISO 8601, inclusive). |
end_date | query | string | Yes | End of date range (ISO 8601, exclusive). |
Response fields
Fields returned in the 200 response body. Nested objects are listed under their parent. A field marked optional may be absent from the body; one marked nullable is always present but its value may be null.
| Field | Type | Description |
|---|---|---|
values | string[] | Unique attribution values. |
truncated | boolean | True when the value list hit the server ceiling and was truncated. The dimension key is free-form on this endpoint, so a high-cardinality key (`session_id`, or a per-event custom key discovered from event metadata) can have far more distinct values than a picker can use. Required rather than optional so every path returning this shape has to state whether it truncated, instead of omitting the field and leaving the caller to assume. |
Error codes
Errors return the standard error envelope with a code, message, and a correlationId you can quote to support.
| Status | When it happens |
|---|---|
400 | Invalid request data. Check that start_date and end_date are valid ISO 8601 dates and fix the field named in error.message. |
401 | Missing or invalid API key. Send your key as Authorization: Bearer YOUR_API_KEY. |
403 | API key lacks the costs:read scope. Create or update an API key with the costs:read scope, then retry. |
429 | Rate limit or plan quota exceeded. Slow down and retry after the current window resets. |
Rate limits and retries
Rate limit or plan quota exceeded. Slow down and retry after the current window resets.