• 1 min read Vercel now supports programmatic access to billing usage and cost data through the API and CLI. • The new /billing/charges endpoint returns data in the FOCUS v1.3 open-standard format, allowing teams to ingest cost data into FinOps tools without custom transformation logic. • The endpoint supports 1-day granularity with a maximum date range of one year. • Responses are streamed as newline-delimited JSON (JSONL) to handle large datasets efficiently. • SDK usage import { Vercel } from “@vercel/sdk”; const vercel = new Vercel({ bearerToken: " “,}); async function run() { const result = await vercel.billing.listBillingCharges({ from: “2025-01-01T00:00:00.000Z”, to: “2025-01-31T00:00:00.000Z”, teamId: “team_1a2b3c4d5e6f7g8h9i0j1k2l”, slug: “my-team-url-slug”, }); for await (const event of result) { // Handle the event console.log(event); }}run(); curl usage curl -N –request GET \ –url ‘https://api.vercel.com/v1/billing/charges?teamId= ’ \ –header ‘Authorization: Bearer ’ \ –header ‘Accept-Encoding: gzip’ \ –compressed CLI usage For quick introspection, the vercel usage command displays billing usage for the current period or a custom date range. • This includes credit-use and costs for each service.

Article Summaries:

  • Vercel has added programmatic access to billing usage and cost data through a new API endpoint and CLI command. The /billing/charges endpoint returns daily‑granularity data in the FOCUS v1.3 open‑standard format, supporting up to one year of history and streaming results as newline‑delimited JSON for large datasets. Developers can retrieve charges via the SDK, curl, or the vercel usage CLI, which also shows current or custom‑range usage and credit usage. Vercel’s native integration with Vantage automatically syncs usage and cost data to FinOps tools, simplifying cost observability. Documentation and examples are available in the API and CLI references.
  • Vercel has added programmatic access to billing usage and cost data through a new API endpoint and CLI commands. The /billing/charges endpoint returns daily‑granularity data in the FOCUS v1.3 open‑standard format, supports up to one year of history, and streams results as newline‑delimited JSON for efficient handling of large datasets. Developers can retrieve charges via the Vercel SDK, cURL, or the vercel usage CLI command, which also shows current or custom‑range usage and costs. Additionally, Vercel announced a native integration with Vantage that automatically syncs usage data for easier cost observability. The update simplifies ingesting billing data into FinOps tools without custom transformations.

Sources: