Skip to main content
GET
List cost usage exports

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

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.

pagination
object | null

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

Example: