# Get billing and usage summary

`GET /v1/billing/summary`

Required OAuth scopes: `billing:read`

## Responses

- `200`
  - `plan` (object, required)
    - `name` (string, required)
    - `status` ("active" | "trialing" | "past_due" | "canceled" | "incomplete" | "unpaid" | "none", required)
    - `isTrial` (boolean, required)
    - `interval` ("monthly" | "annual" | null, required)
    - `priceCents` (integer | null, required)
    - `unlimited` (boolean, required)
    - `renewsAt` (string (date-time) | null, required)
    - `cancelAtPeriodEnd` (boolean, required)
  - `usage` (object, required)
    - `included` (object | null, required)
    - `topUpFundsDollars` (number, required)
- `400`: Invalid request
- `401`: Missing or invalid Bearer credential
- `402`: Payment or subscription required
- `403`: Credential is missing a required scope
- `404`: Resource not found
- `409`: Request conflict
- `429`: Rate limit exceeded
- `500`: Internal API error