New Billing API Endpoint

Vercel has launched a new /billing/charges API endpoint that enables programmatic access to billing usage and cost data. This addition addresses a key need for teams managing infrastructure costs across multiple services.

Key Features

• FOCUS v1.3 Compliance: Data is returned in the FOCUS (FinOps Open Cost and Usage Specification) v1.3 format, an open standard that eliminates the need for custom transformation logic when integrating with FinOps platforms.
• Flexible Date Ranges: Supports 1-day granularity with a maximum date range of one year, allowing both recent cost analysis and historical retrospectives.
• Efficient Data Streaming: Responses are streamed as newline-delimited JSON (JSONL) to handle large datasets efficiently without memory constraints.

Access Methods

Teams can query billing data through multiple interfaces:

• SDK: Use the Vercel TypeScript SDK with vercel.billing.listBillingCharges() for type-safe integration
• REST API: Direct HTTP requests to the /v1/billing/charges endpoint with bearer token authentication
• CLI: The vercel usage command provides quick access to billing data for the current period or custom date ranges

Ecosystem Integration

Vantage has released a native integration that automatically syncs Vercel cost data to Vantage accounts, simplifying multi-tool cost observability without manual data exports.

Refer to the API documentation and CLI reference for implementation details.