## Vercel Billing Usage and Cost Data API

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](https://focus.finops.org/), 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

```typescript
import { Vercel } from "@vercel/sdk";

const vercel = new Vercel({
  bearerToken: "<YOUR_BEARER_TOKEN_HERE>",
});

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

```bash
curl -N --request GET \
  --url 'https://api.vercel.com/v1/billing/charges?teamId=<team>' \
  --header 'Authorization: Bearer <token>' \
  --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.

**View usage for the current billing period**

```bash
vercel usage
```

**View usage for a custom date range**

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

Vantage has also 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](https://www.vantage.sh/blog/vercel-cost-management) for details.

Learn more in the [API documentation](/content/docs/rest-api/billing/list-focus-billing-charges/index.html) and [CLI reference](/content/docs/cli/usage/index.html).