---
title: "List S3 Upcoming Invoices"
method: GET
path: "/api/v1/ledger/s3/upcoming-invoices"
tags: ["User APIs", "ledger-platform"]
---

# List S3 Upcoming Invoices

`GET /api/v1/ledger/s3/upcoming-invoices`

The Next Billing apply surface: one row per upcoming Block invoice.

## Response `200`

Successful Response

- S3UpcomingInvoicesResponse — The apply surface's header plus its rows. The three header figures come straight from ``S3BalanceSummaryResponse`` and keep its names, so the apply header can never disagree with the wallet tiles. ``reserved`` is what the wireframe labels "Applied to upcoming invoices" — the UI supplies that wording; the field stays ``reserved`` because no consumption has happened yet.
  - `available` string, required
  - `reserved` string, required
  - `remaining` string, required
  - `invoices` S3UpcomingInvoiceRow[], required
    - `block_contract_id` string, uuid, required
    - `dataset_id` string, required
    - `dataset_label` string, nullable
    - `cut` string, nullable
    - `period_seq` integer, required
    - `period_start` string, date-time, nullable
    - `send_date` string, date-time, nullable
    - `days_until_send` integer, nullable
    - `invoice_amount` string, required
    - `max_applicable_tokens` string, required
    - `applied_tokens` string, required
    - `net_due` string, required
    - `reservation_id` string, uuid, nullable
    - `editable` boolean
    - `auto_apply_enabled` boolean
    - `auto_default_tokens` string
    - `recurring_override_tokens` string, nullable
    - `applied_source` string, nullable

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)