> ## Documentation Index > Fetch the complete documentation index at: https://docs.pinecone.io/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml get /admin/cost-usage-exports openapi: 3.0.3 info: title: Pinecone Admin API description: > Provides an API for managing a Pinecone organization and its resources, including projects, API keys, organization users and invites, service accounts, role bindings, and cost usage exports. contact: name: Pinecone Support url: https://support.pinecone.io email: support@pinecone.io license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0 version: 2026-07 servers: - url: https://api.pinecone.io description: Production API endpoints security: - BearerAuth: [] tags: - name: API Keys description: Actions that manage API Keys. - name: Organizations description: Actions that manage organizations. - name: Projects description: Actions that manage projects. - name: Users description: >- Actions that manage users. Role bindings are not included in user responses; use the Role Bindings endpoints to view them. - name: Invites description: >- Actions that manage invites. An invite's role bindings are first-class and appear in the Role Bindings endpoints with `principal_type=invite`. - name: Service Accounts description: >- Actions that manage service accounts. Role bindings are not included in service account responses; use the Role Bindings endpoints to view them. - name: Role Bindings description: Actions that manage role bindings. - name: Cost Usage Exports description: Actions that export an organization's cost and usage records as a file. paths: /admin/cost-usage-exports: get: tags: - Cost Usage Exports summary: List cost usage exports description: > 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. operationId: list_cost_usage_exports parameters: - in: header name: X-Pinecone-Api-Version description: Required date-based version header required: true schema: default: 2026-07 type: string style: simple - in: query name: status description: >- 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. schema: type: array items: example: Completed description: >- 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`. x-enum: - Pending - InProgress - Completed - Failed type: string example: - Pending - InProgress explode: false style: form - in: query name: limit description: >- The number of results to return per page. When omitted, the server defaults to 100. Out-of-range values return `400 OUT_OF_RANGE`. schema: default: 100 type: integer minimum: 1 maximum: 100 style: form - in: query name: paginationToken description: >- Cursor from `pagination.next` of a prior response. Must be reused with the same query context (path parameters, filters, and `limit`). schema: type: string style: form responses: '200': description: >- 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. content: application/json: schema: $ref: '#/components/schemas/CostUsageExportList' examples: recent-exports: summary: Recent exports, newest first value: 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== running-export: summary: Filtered to the export running now value: data: - created_at: '2026-09-02T14:31:07.000Z' data_available_through: null download_url: null download_url_expires_at: null error: null file_expired: false file_expires_at: null finished_at: null 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: null size_bytes: null started_at: '2026-09-02T14:31:19.000Z' status: InProgress updated_at: '2026-09-02T14:31:19.000Z' pagination: null no-exports: summary: No exports yet value: data: [] pagination: null '400': description: >- Bad request. The `status` filter, `limit`, or `paginationToken` was not usable. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unknown-status: summary: Status filter is not a known status value: error: code: INVALID_ARGUMENT message: >- Unknown status 'Running'. Valid values are Pending, InProgress, Completed, Failed. Omit the parameter to list every status. status: 400 stale-pagination-token: summary: Pagination token is invalid or expired value: error: code: INVALID_ARGUMENT message: Invalid pagination token status: 400 '401': description: 'Unauthorized. Possible causes: Invalid API key.' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unauthorized: summary: Unauthorized value: error: code: UNAUTHENTICATED message: Invalid API key. status: 401 '403': description: >- Forbidden. Either the service account lacks the permission, or the organization's plan does not include this feature. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing-permission: summary: Service account lacks the permission value: error: code: PERMISSION_DENIED message: >- This service account cannot read cost usage exports. Grant it the OrgOwner or OrgBillingAdmin role. status: 403 plan-not-entitled: summary: Plan does not include cost usage exports value: error: code: PERMISSION_DENIED message: >- Cost usage exports are available to organizations on the Enterprise plan. status: 403 '500': description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: internal-server-error: summary: Internal server error value: error: code: UNKNOWN message: Internal server error status: 500 4XX: description: Unexpected error on request. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: CostUsageExportList: example: 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' pagination: next: eyJsYXN0X2lkIjoiOWYyYzFhNGUifQ== description: A paginated list of cost usage exports. type: object properties: data: description: >- 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. type: array items: $ref: '#/components/schemas/CostUsageExport' pagination: nullable: true description: >- Cursor envelope for the next page. `null` (or absent) on the final page of results. type: object allOf: - example: next: eyJsYXN0X2lkIjogImluZGV4LTQifQ== description: >- Pagination metadata for list responses. When `next` is present, pass it as `paginationToken` on the following request. x-component-name: PaginationResponse type: object properties: next: example: eyJsYXN0X2lkIjogImluZGV4LTQifQ== description: >- Opaque cursor for the next page. Do not parse or construct. Invalid or expired tokens return `400`. type: string required: - data ErrorResponse: example: error: code: QUOTA_EXCEEDED message: >- The index exceeds the project quota of 5 pods by 2 pods. Upgrade your account or change the project settings to increase the quota. status: 429 description: The response shape used for all error responses. type: object properties: status: example: 500 description: The HTTP status code of the error. type: integer error: example: code: INVALID_ARGUMENT message: >- Index name must contain only lowercase alphanumeric characters or hyphens, and must not begin or end with a hyphen. description: Detailed information about the error that occurred. type: object properties: code: description: >- The error code. Possible values: `OK`, `UNKNOWN`, `INVALID_ARGUMENT`, `DEADLINE_EXCEEDED`, `QUOTA_EXCEEDED`, `NOT_FOUND`, `ALREADY_EXISTS`, `PERMISSION_DENIED`, `UNAUTHENTICATED`, `RESOURCE_EXHAUSTED`, `FAILED_PRECONDITION`, `ABORTED`, `OUT_OF_RANGE`, `UNIMPLEMENTED`, `INTERNAL`, `UNAVAILABLE`, `DATA_LOSS`, `FORBIDDEN`, or `UNPROCESSABLE_ENTITY`. x-enum: - OK - UNKNOWN - INVALID_ARGUMENT - DEADLINE_EXCEEDED - QUOTA_EXCEEDED - NOT_FOUND - ALREADY_EXISTS - PERMISSION_DENIED - UNAUTHENTICATED - RESOURCE_EXHAUSTED - FAILED_PRECONDITION - ABORTED - OUT_OF_RANGE - UNIMPLEMENTED - INTERNAL - UNAVAILABLE - DATA_LOSS - FORBIDDEN - UNPROCESSABLE_ENTITY type: string message: example: >- Index name must contain only lowercase alphanumeric characters or hyphens, and must not begin or end with a hyphen. type: string details: description: >- Additional information about the error. This field is not guaranteed to be present. type: object required: - code - message required: - status - error CostUsageExport: description: >- The CostUsageExport describes an asynchronous job that produces a cost and usage file for an organization, together with the link used to download that file. The file holds cost records that follow the FOCUS v1.4 Cost and Usage dataset. type: object properties: id: example: 9f2c1a4e-8b3d-4c5f-a1b2-c3d4e5f6a7b8 description: >- Unique identifier for the export. Use it to poll for completion, and to identify the export when contacting Pinecone Support. type: string format: uuid status: example: Completed description: >- 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`. x-enum: - Pending - InProgress - Completed - Failed type: string format: example: zip description: >- Encoding of the generated file. `zip` is a zip archive holding the cost records as one or more CSV files whose columns follow the FOCUS v1.4 Cost and Usage dataset, alongside a `manifest.json` describing the archive. Each CSV starts with a header line and holds at most 800,000 rows, so larger exports are split across several files, named `part-1-of-3.csv` through `part-3-of-3.csv` and ordered by those names. Every CSV carries these 45 columns, in this order: `x_OrganizationId`, `SubAccountId`, `ResourceName`, `ResourceType`, `ChargePeriodStart`, `ChargePeriodEnd`, `BillingPeriodStart`, `BillingPeriodEnd`, `SkuId`, `ServiceName`, `PricingQuantity`, `PricingUnit`, `ConsumedQuantity`, `ConsumedUnit`, `ListUnitPrice`, `ListCost`, `ContractedUnitPrice`, `ContractedCost`, `EffectiveCost`, `BilledCost`, `BillingCurrency`, `PricingCategory`, `ChargeCategory`, `ChargeClass`, `ChargeFrequency`, `ServiceCategory`, `ServiceSubcategory`, `RegionId`, `RegionName`, `HostProviderName`, `ServiceProviderName`, `InvoiceIssuerName`, `InvoiceId`, `BillingAccountId`, `BillingAccountName`, `BillingAccountType`, `SubAccountName`, `SubAccountType`, `ResourceId`, `SkuPriceId`, `SkuMeter`, `ChargeDescription`, `x_CloudId`, `Tags`, `x_ProjectMetadata`. Columns prefixed with `x_` are Pinecone extensions, which is how FOCUS requires a provider to name a column the specification does not define. `SubAccountId` and `SubAccountName` identify the Pinecone project, and `BillingAccountId` identifies the organization that is invoiced. Rows are ordered by `ChargePeriodStart`, `SubAccountName`, `ResourceName`, `ChargeDescription`, `SkuId`, `ResourceId`, across the archive as a whole rather than within each file. `InvoiceId` is provisional while its billing period is still open, so it may change for a period that has not yet closed. Possible values: `zip`. x-enum: - zip type: string period_start: example: '2026-08-01T00:00:00.000Z' description: >- First day of usage covered by the export, as a UTC calendar day. This bound is inclusive. type: string format: date period_end: example: '2026-09-01T00:00:00.000Z' description: >- Day after the last day of usage covered by the export, as a UTC calendar day. This bound is exclusive. type: string format: date data_available_through: nullable: true example: '2026-08-31T00:00:00.000Z' description: >- Last day for which the billing warehouse holds complete data, recorded when the export runs to describe the contents of the generated file. `null` until then. Cost data lags by roughly two days. type: string format: date row_count: nullable: true example: 48213 description: >- Number of line items across all CSV files in the archive, excluding header lines. type: integer format: int64 size_bytes: nullable: true example: 4183902 description: Length of the zip archive, in bytes. type: integer format: int64 download_url: nullable: true example: >- https://storage.googleapis.com/example-bucket/cost_usage_exports/export.zip?X-Goog-Expires=3600 description: >- Signed link to the generated file, generated fresh each time a single export is read and valid for one hour. Treat the link as a secret: anyone holding it can download the file. Do not store it or pass it between systems; read the export again for a new link. Always `null` in list responses. type: string format: uri download_url_expires_at: nullable: true example: '2026-09-02T15:36:11.000Z' description: >- When `download_url` stops working: one hour after the link was generated, or `file_expires_at`, whichever comes first. Read the export again for a new link. Always `null` in list responses. type: string format: date-time file_expires_at: nullable: true example: '2026-09-04T14:35:52.000Z' description: >- When the generated file is deleted, two days after the export finished. The file cannot be re-delivered afterwards; create another export instead. type: string format: date-time file_expired: example: false description: >- Whether the generated file has been deleted. Check this rather than `status`: a `Completed` export whose file has expired can no longer be downloaded. type: boolean error: $ref: '#/components/schemas/CostUsageExportError' created_at: example: '2026-09-02T14:31:07.000Z' description: When the export was accepted. type: string format: date-time started_at: nullable: true example: '2026-09-02T14:31:19.000Z' description: When the export job began running. type: string format: date-time finished_at: nullable: true example: '2026-09-02T14:35:52.000Z' description: >- When the export job finished running, either successfully or with an error. type: string format: date-time updated_at: example: '2026-09-02T14:35:52.000Z' description: When the export was last updated. type: string format: date-time required: - id - status - format - period_start - period_end - file_expired - created_at - updated_at CostUsageExportError: nullable: true description: Why an export failed. type: object properties: code: example: DEADLINE_EXCEEDED description: >- Machine-readable classification of the failure. `DEADLINE_EXCEEDED` means the export ran out of time and a shorter window may succeed; `INTERNAL` covers every other failure and is worth retrying once. Possible values: `DEADLINE_EXCEEDED` or `INTERNAL`. x-enum: - DEADLINE_EXCEEDED - INTERNAL type: string message: example: >- The export did not finish within the time budget. Create a new export, or request a shorter window. description: Human-readable explanation of what went wrong and what to try next. type: string required: - code - message securitySchemes: BearerAuth: type: http scheme: bearer description: > An [access token](https://docs.pinecone.io/guides/organizations/manage-service-accounts#retrieve-an-access-token) must be provided in the `Authorization` header using the `Bearer` scheme. ````