Access billing usage and cost data via API

Source: Vercel Blog

Overview

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

View usage for the current billing period

vercel usage

View usage for a custom date range

vercel usage --from 2025-01-01 --to 2025-01-31

Integration

Vantage has released a native integration that connects Vercel teams to Vantage accounts. This automatically syncs usage and cost data alongside other tools, simplifying cost observability. Read the Vantage announcement blog for details.

Further reading

• API documentation: https://docs.vercel.com/docs/rest-api/reference/endpoints/billing/list-focus-billing-charges
• CLI reference: https://vercel.com/docs/cli/usage