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

# List Invoices

> List all funding invoices

Returns a list of all Lightning invoices and card payment sessions for your account.

## Query Parameters

<ParamField query="status" type="string">
  Filter by status: `pending`, `paid`, `expired`
</ParamField>

<ParamField query="limit" type="number">
  Maximum number of results (default: 50, max: 100)
</ParamField>

<ParamField query="offset" type="number">
  Number of results to skip (for pagination)
</ParamField>

## Response

<ResponseField name="invoices" type="array">
  Array of invoice objects

  <Expandable title="Invoice object">
    <ResponseField name="id" type="string">
      Invoice ID
    </ResponseField>

    <ResponseField name="type" type="string">
      `lightning` or `card`
    </ResponseField>

    <ResponseField name="amountSats" type="number">
      Amount in satoshis (for Lightning)
    </ResponseField>

    <ResponseField name="amountUsdCents" type="number">
      Amount in USD cents (for card)
    </ResponseField>

    <ResponseField name="status" type="string">
      `pending`, `paid`, or `expired`
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 timestamp
    </ResponseField>

    <ResponseField name="paidAt" type="string">
      ISO 8601 timestamp (if paid)
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.saturn-pay.com/v1/wallet/invoices?status=paid&limit=10" \
    -H "Authorization: Bearer sk_agt_..."
  ```

  ```typescript Node.js theme={null}
  const response = await fetch('https://api.saturn-pay.com/v1/wallet/invoices?status=paid', {
    headers: { 'Authorization': 'Bearer sk_agt_...' }
  });

  const { invoices } = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "invoices": [
      {
        "id": "inv_abc123",
        "type": "lightning",
        "amountSats": 10000,
        "status": "paid",
        "createdAt": "2024-01-19T10:00:00Z",
        "paidAt": "2024-01-19T10:01:23Z"
      },
      {
        "id": "inv_def456",
        "type": "card",
        "amountUsdCents": 2500,
        "status": "paid",
        "createdAt": "2024-01-18T14:30:00Z",
        "paidAt": "2024-01-18T14:32:00Z"
      }
    ],
    "total": 2,
    "limit": 50,
    "offset": 0
  }
  ```
</ResponseExample>