---
title: "Retrieve a list of all client invoices"
method: GET
path: "/subscription/invoices"
---

# Retrieve a list of all client invoices

`GET /subscription/invoices`

Fetch all invoices for a client based on the payment system. Supports Stripe, Paddle, PayPal, and Primer payment systems.

## Query parameters

- `pay_system_id` string, required — ID of the subscription in external Stripe/Paddle/PayPal/Primer, e.g. sub_1PzNJzCsRq5tBi2bbfNsAf86or I-H7HC902MYM49
- `limit` integer — Number of records to retrieve (default: 100, max: 1000).
- `offset` string — Pagination offset using the ID of the last invoice on the page. For Stripe: starting_after parameter, for Paddle: after parameter.

## Response `200`

List of invoices retrieved successfully.

- object
  - `success` integer
  - `error` integer
  - `data` object[] — Array of invoice objects. Structure varies by payment system.

## Other responses

- `400` — Invalid input or parameters.

---

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