---
title: "Credits per mission, grants, adjustments and expiries, newest first"
method: GET
path: "/billing/ledger"
tags: ["billing"]
---

# Credits per mission, grants, adjustments and expiries, newest first

`GET /billing/ledger`

## Request

- Base URL: `https://api.letsship.ai/v1`
- URL: `https://api.letsship.ai/v1/billing/ledger`
- Auth: none declared

## Query parameters

- `orgId` string
- `cursor` string
- `limit` integer

## Response `200`

Ledger page

- ListLedgerResponse
  - `entries` LedgerEntry[], required
    - `id` string, required
    - `kind` 'mission' | 'grant' | 'adjustment' | 'expiry', required
    - `at` integer, required
    - `credits` integer, required
    - `mode` 'enforce' | 'shadow' | 'off', required
    - `mission` object, nullable, required
      - `issueId` string, required
      - `title` string, nullable, required
      - `starts` integer, required
      - `extraBlocks` integer, required
      - `messages` integer, required
      - `refunded` integer, required
    - `grant` object, nullable, required
      - `kind` 'trial' | 'sponsored' | 'plan' | 'contract' | 'purchase', required
      - `expiresAt` integer, nullable, required
    - `reason` string, nullable, required
  - `nextCursor` string, nullable, required

## Other responses

- `401`: Unauthenticated
- `403`: Caller lacks billing:manage (code billing_manage_required)
- `404`: Not one of the caller's orgs

---

[API](https://skmtc.dev/letsship/apis/ship-api.md) · [All operations](https://skmtc.dev/letsship/apis/ship-api/llms.txt) · [OpenAPI document](https://skmtc.dev/letsship/apis/ship-api/revisions/e6eac1bcadd4?raw)