---
title: "List FOCUS billing charges"
method: GET
path: "/v1/billing/charges"
tags: ["billing"]
---

# List FOCUS billing charges

`GET /v1/billing/charges`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/billing/charges`
- Auth: HTTP bearer

Returns the billing charge data in FOCUS v1.3 JSONL format for a specified Vercel team, within a date range specified by `from` and `to` query parameters. Supports 1-day granularity with a maximum date range of 1 year. The response is streamed as newline-delimited JSON (JSONL) and can be optionally compressed with gzip if the `Accept-Encoding: gzip` header is provided. `SkuId` is the stable product ID. For unmapped items, it is derived from the item identifier. This is only available for Owner, Member, Developer, Security, Billing, and Enterprise Viewer roles for the supplied team.

## Query parameters

- `from` string, required: Inclusive start of the date range as an ISO 8601 date-time string in UTC.
- `to` string, required: Exclusive end of the date range as an ISO 8601 date-time string in UTC.
- `teamId` string
- `slug` string

## Response `200`

## Other responses

- `400`: One of the provided values in the request query is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`
- `410`
- `500`
- `503`

## Changes

- **2026-09-30** `099fbe1f521c`: 1 info
  - added the required property `SkuId` to the response with the `200` status
- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2026-06-11** `14b4658f819e`: 2 breaking
  - the response property `ConsumedQuantity` became nullable for the status `200`
  - the response property `ConsumedUnit` became nullable for the status `200`
- **2026-02-10** `486a07653d6e`: 2 breaking, 6 info
  - added the new required `query` request parameter `from`
  - added the new required `query` request parameter `to`
  - api operation id `listBillingCharges` was added
  - api tag `billing` added
  - …4 more
- **2026-02-02** `5264f094c3d3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v1/billing/charges/get.md)

---

[API](https://skmtc.dev/vercel/apis/vercel-api.md) - [All operations](https://skmtc.dev/vercel/apis/vercel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/vercel-api/revisions/60686c0e1f6a?raw)