curl --request POST \
--url https://api.pinecone.io/admin/cost-usage-exports \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Pinecone-Api-Version: <x-pinecone-api-version>' \
--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": null,
"status": "Pending",
"updated_at": "2026-09-02T14:31:07.000Z"
}Create a cost usage export
Start an asynchronous export of an organization’s cost usage data. Only one export can run at a time and only a limited number of exports can be triggered per hour. The generated file is kept for two days.
curl --request POST \
--url https://api.pinecone.io/admin/cost-usage-exports \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Pinecone-Api-Version: <x-pinecone-api-version>' \
--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": null,
"status": "Pending",
"updated_at": "2026-09-02T14:31:07.000Z"
}Authorizations
An access token must be provided in the Authorization header using the Bearer scheme.
Body
The window of usage to cover. Omit the body to export the trailing 30 complete days.
The window of usage to cover, given as a half-open range of UTC calendar days.
Response
The export was accepted and durably recorded. It has not run yet.
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.
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.
"zip"
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.
"https://storage.googleapis.com/example-bucket/cost_usage_exports/export.zip?X-Goog-Expires=3600"
Was this page helpful?