# Billing

> Access billing summary and credit balance data in the Lev API.

Source: https://www.lev.com/docs/build/billing

Last updated: May 2026

---
## Overview

The billing surface is read-only. Both endpoints require the `billing:read` scope and return data for the authenticated caller's active account.

`GET /billing/summary` returns subscription metadata and the credit balance in one response. Use it when you need the account's billing status.

`GET /billing/credits/balance` returns only the credit balance block. Use it when the subscription fields are not needed.

  `enabled=false` with `balance=null` means the account is not provisioned for credit-based billing. `enabled=true` with `balance=0` means the account is provisioned and has zero credits available.

## Billing Summary

### `GET /api/external/v2/billing/summary`

Get subscription metadata and credit balance for the active account

Response: `200`

#### Error Responses

- **401** (unauthorized): Authentication required
- **403** (forbidden): Missing required scope: billing:read

## Credit Balance

### `GET /api/external/v2/billing/credits/balance`

Get the credit balance for the active account

Response: `200`

#### Error Responses

- **401** (unauthorized): Authentication required
- **403** (forbidden): Missing required scope: billing:read

## Billing Objects

### Subscription object

| Field | Type | Description |
|-------|------|-------------|
| `type` | string\|null | Subscription type for the active account |
| `status` | string\|null | Current subscription status |
| `billing_cycle` | string\|null | Billing cadence, such as `monthly` or `annual` |
| `end_date` | string\|null | Subscription end date as an ISO 8601 date |

### Credits object

| Field | Type | Description |
|-------|------|-------------|
| `enabled` | boolean | Whether the active account is provisioned for credit-based billing |
| `balance` | integer\|null | Current credit balance, or `null` when credits are not enabled |
| `unit` | string | Balance unit. Current value is `credits` |