---
title: "List invoices"
method: GET
path: "/user/invoices"
tags: ["user-invoices"]
---

# List invoices

`GET /user/invoices`

List Stripe invoices for the authenticated customer.

Use this endpoint for billing history pages and invoice tables.

Pagination:
- `limit` controls page size (1-100).
- `startingAfter` continues from a previous page token.
- Response includes `hasMore` and `nextStartingAfter` for pagination UX.

Behavior:
- If the user has no Stripe customer link yet, returns an empty list rather than an error.

## Query parameters

- `limit` integer — Maximum number of invoices to return.
- `startingAfter` string — Stripe invoice ID to start after. Use the value from `nextStartingAfter` of the previous response.

## Response `200`

Paginated Stripe invoices for the authenticated user.

- InvoiceListResponse
  - `invoices` InvoiceSummary[], required — Collection of Stripe invoices for the authenticated customer.
    - `id` string, required — Unique identifier for the Stripe invoice record.
    - `number` string, nullable, required — Human-friendly invoice number generated by Stripe when the invoice is finalized.
    - `amountDue` number, required — Total amount due for the invoice in the smallest currency unit.
    - `createdAt` string, required — ISO 8601 timestamp representing when the invoice was created.
  - `hasMore` boolean, required — Indicates whether more invoices are available beyond the current page.
  - `nextStartingAfter` string, nullable, required — Identifier to pass as `startingAfter` in the next request when `hasMore` is true.

---

[API](https://skmtc.net/managem/apis/managem-api.md) · [All operations](https://skmtc.net/managem/apis/managem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/managem/managem-api/versions/e8d78a3a2e8b/schema)