---
title: "Get Billing"
method: GET
path: "/user/billing"
tags: ["user"]
---

# Get Billing

`GET /user/billing`

Fetches billing usage and quota information for the authenticated user. Can be scoped to a specific context (e.g. project or namespace).

## Query parameters

- `scope` string — Filters billing data by a specific scope, such as a project ID or slug.

## Response `200`

Success

- union
  - object
    - `billingType` 'token', required
    - `data` object, required
      - `plan` string, required
      - `billingMode` 'test'
      - `role` string, required
      - `billingCycle` object, required
        - `start` number, required
        - `end` number, required
      - `balance` object, required
        - `remaining` number, required
        - `total` number, required
      - `onDemand` object, required
        - `balance` number, required
        - `blocks` object[]
          - `expirationDate` number
          - `effectiveDate` number, required
          - `originalBalance` number, required
          - `currentBalance` number, required
  - object
    - `billingType` 'legacy', required
    - `data` object, required
      - `remaining` number
      - `reset` number
      - `limit` number, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `413` — Payload Too Large
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/vercel/apis/v0-platform-api-beta.md) · [All operations](https://skmtc.dev/vercel/apis/v0-platform-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vercel/v0-platform-api-beta/revisions/8b21bf5afcfa/schema)