List cost usage exports

List the cost usage exports belonging to your organization, newest first.

List items never carry a download link: download_url and download_url_expires_at are always null here. Request a single export to generate one.

GET /admin/cost-usage-exports

List cost usage exports

cURL

curl --request GET \
  --url https://api.pinecone.io/admin/cost-usage-exports \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Pinecone-Api-Version: <x-pinecone-api-version>'

200

recent-exports

{
  "data": [
    {
      "created_at": "2026-09-02T14:31:07.000Z",
      "data_available_through": "2026-08-31T00:00:00.000Z",
      "download_url": null,
      "download_url_expires_at": null,
      "error": null,
      "file_expired": false,
      "file_expires_at": "2026-09-04T14:35:52.000Z",
      "finished_at": "2026-09-02T14:35:52.000Z",
      "format": "zip",
      "id": "9f2c1a4e-8b3d-4c5f-a1b2-c3d4e5f6a7b8",
      "period_end": "2026-09-01T00:00:00.000Z",
      "period_start": "2026-08-01T00:00:00.000Z",
      "row_count": 48213,
      "size_bytes": 4183902,
      "started_at": "2026-09-02T14:31:19.000Z",
      "status": "Completed",
      "updated_at": "2026-09-02T14:36:11.000Z"
    },
    {
      "created_at": "2026-08-20T09:10:22.000Z",
      "data_available_through": "2026-08-18T00:00:00.000Z",
      "download_url": null,
      "download_url_expires_at": null,
      "error": null,
      "file_expired": true,
      "file_expires_at": "2026-08-22T09:14:38.000Z",
      "finished_at": "2026-08-20T09:14:38.000Z",
      "format": "zip",
      "id": "4c7b0d92-1e5a-4f83-9c21-7ab6d4e08f31",
      "period_end": "2026-08-01T00:00:00.000Z",
      "period_start": "2026-07-01T00:00:00.000Z",
      "row_count": 46102,
      "size_bytes": 3998214,
      "started_at": "2026-08-20T09:10:31.000Z",
      "status": "Completed",
      "updated_at": "2026-08-22T09:14:38.000Z"
    }
  ],
  "pagination": {
    "next": "eyJsYXN0X2lkIjoiNGM3YjBkOTIifQ=="
  }
}

Authorizations

Authorization · string · header · required

An access token must be provided in the Authorization header using the Bearer scheme.

Headers

X-Pinecone-Api-Version · string · default: 2026-07 · required

Required date-based version header

Query Parameters

status · string[]

Filter by status. Supply a comma-separated list to match any of several statuses: status=Pending,InProgress returns the export that is running now, if there is one.

Status of a cost usage export. Pending and InProgress mean the job is still running; Completed and Failed are terminal and never change afterwards. Possible values: Pending, InProgress, Completed, or Failed.

limit · integer · default: 100

The number of results to return per page. When omitted, the server defaults to 100. Out-of-range values return 400 OUT_OF_RANGE.

Required range: 1 <= x <= 100

paginationToken · string

Cursor from pagination.next of a prior response. Must be reused with the same query context (path parameters, filters, and limit).

Response

200

application/json

A paginated list of cost usage exports. An export outlives its file, so most items are Completed with file_expired set to true; check that field, not status, to find the exports that can still be downloaded.

A paginated list of cost usage exports.

data · object[] · required

The page of cost usage exports, newest first. download_url and download_url_expires_at are always null here; request a single export to get a link.

Show child attributes

pagination · object | null

Cursor envelope for the next page. null (or absent) on the final page of results.

Show child attributes

Example:

{
  "next": "eyJsYXN0X2lkIjogImluZGV4LTQifQ=="
}