Export Metric Results as CSV
Exports metric results as a CSV file.
By default, with no pagination parameters, the endpoint streams the entire matching result set as a single CSV. To page through results instead, pass limit and starting_after / ending_before. Paginated responses include the X-Has-More and X-Next-Cursor headers. Up to 100,000 rows can be exported per request in either mode; requests whose total matching set exceeds this cap return a 400 error.
Authorizations
Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.
Headers
API version header.
2026-03-01 "2026-03-01"
Query Parameters
The ID of the agent.
The ID of the deployment.
The ID of the metric.
The ID of the call.
Filter metric results created at or after this RFC 3339 datetime.
"2024-04-01T00:00:00Z"
Filter metric results created before or at this RFC 3339 datetime.
"2024-04-30T23:59:59Z"
The maximum number of rows to return in this CSV page, between 1 and 1000. Passing this parameter enables paginated mode; omit it (along with starting_after and ending_before) to stream the full result set.
1 <= x <= 1000An opaque pagination cursor. Returns the page of results after this cursor. Pass the X-Next-Cursor value from the previous page to fetch the next page. Treat the cursor as an opaque string. Cannot be combined with ending_before.
An opaque pagination cursor. Returns the page of results before this cursor. Treat the cursor as an opaque string. Cannot be combined with starting_after.
Response
Successfully exported metric results as a CSV file.
The response is of type file.