---
title: "List Generated Invoices"
method: GET
path: "/api/v1/admin/block/s3-invoices/generated"
tags: ["Admin APIs", "block-s3-invoices"]
---

# List Generated Invoices

`GET /api/v1/admin/block/s3-invoices/generated`

Invoices already sent, with what the tokens took off them.

The counterpart to the upcoming view: once an invoice goes out it leaves that surface, and
without this the applied tokens have nowhere to be seen after the fact. ``has_more`` says
outright whether the page was capped rather than leaving it inferred from a full page.

## Query parameters

- `client_id` string, nullable — Narrow to one client; omit for every Block client.
- `limit` integer — Maximum invoices to return, newest sent first.

## Response `200`

Successful Response

- BlockGeneratedInvoicesResponse
  - `invoices` BlockGeneratedInvoiceRow[], required
    - `block_invoice_draft_id` string, uuid, required
    - `stripe_invoice_id` string, required
    - `client_id` string, uuid, required
    - `client_name` string, nullable
    - `dataset_id` string, nullable
    - `dataset_label` string, nullable
    - `cut` string, nullable
    - `period_seq` integer, nullable
    - `period_start` string, date-time, nullable
    - `sent_at` string, date-time, nullable
    - `contract_monthly` string, nullable
    - `invoice_amount_cents` integer, nullable
    - `tokens_applied_cents` integer, nullable
    - `net_cents` integer, nullable
  - `total_invoices` integer, required
  - `has_more` boolean

## Other responses

- `422` — Validation Error

---

[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)