> ## Documentation Index
> Fetch the complete documentation index at: https://docs.launchmystore.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Invoices

> List invoices for the merchant store with pagination and date filters.

Paginated list of subscription invoices for the merchant — newest first. Each
invoice corresponds to one charge attempt against a subscription.

**Required scope:** `read_billing`

## Query Parameters

<ParamField query="limit" type="number" default="20">
  Page size (1–100).
</ParamField>

<ParamField query="page" type="number" default="1">
  Page number, 1-indexed.
</ParamField>

<ParamField query="from" type="string">
  Filter `createdAt >= from`. ISO 8601 date or `YYYY-MM-DD`.
</ParamField>

<ParamField query="to" type="string">
  Filter `createdAt <= to`. ISO 8601 date or `YYYY-MM-DD`.
</ParamField>

## Response

<ResponseField name="data" type="object">
  <Expandable title="invoices">
    <ResponseField name="invoices" type="array">
      Invoice rows: `subscriptionId`, `planType`, `planDuration`, `amount`,
      `currency`, `status`, `subscriptionEndingDate`, `paymentGateway`,
      `invoiceId`, `createdAt`.
    </ResponseField>

    <ResponseField name="pagination" type="object">
      `{ total, page, limit, totalPages }`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": 200,
    "state": "success",
    "message": null,
    "data": {
      "invoices": [
        {
          "subscriptionId": "7f04abcb-5370-4e61-9857-5d477313a5e9",
          "planType": "Trial",
          "planDuration": null,
          "amount": "0.00",
          "currency": "INR",
          "status": "expired",
          "subscriptionEndingDate": "2026-02-15T18:19:04.275Z",
          "paymentGateway": "Stripe",
          "invoiceId": null,
          "createdAt": "2026-02-08T18:19:04.276Z"
        }
      ],
      "pagination": { "total": 1, "page": 1, "limit": 20, "totalPages": 1 }
    },
    "pagination": null
  }
  ```
</ResponseExample>