---
title: "List all payment receipts"
method: GET
path: "/payment_receipts"
tags: ["payment_receipts"]
---

# List all payment receipts

`GET /payment_receipts`

This endpoint is used to list all existing payment receipts.

## Query parameters

- `page` integer
- `per_page` integer
- `invoice_id` string

## Response `200`

PaymentReceipts

- PaymentReceiptsPaginated
  - `payment_receipts` PaymentReceiptObject[], required
    - `lago_id` string, uuid, required — Unique identifier of the payment receipt, created by Lago.
    - `created_at` string, date-time, required — The date and time when the payment receipt was created. It is expressed in UTC format according to the ISO 8601 datetime standard. This field provides the timestamp for the exact moment when the payment receipt was initially created.
    - `number` string, required — The unique number assigned to the payment receipt.
    - `payment` PaymentObject, required
      - `lago_id` string, uuid, required — The unique identifier of the payment, created by Lago.
      - `lago_customer_id` string, uuid, required — Unique identifier of the customer, created by Lago.
      - `external_customer_id` string, required — The customer external unique identifier (provided by your own application)
      - `invoice_ids` string[], required — List of invoice IDs associated with the payment.
      - `invoice_numbers` string[] — List of invoice numbers associated with the payment.
      - `lago_payable_id` string, uuid, required — The unique identifier of the paid resource, created by Lago.
      - `payable_type` 'Invoice' | 'PaymentRequest', required — The type of the paid resource, associated with the `lago_payable_id`.
      - `amount_cents` integer, required — The amount of the payment in cents.
      - `amount_currency` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'ISK' | 'JMD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KRW' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRO' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SEK' | 'SGD' | 'SHP' | 'SLL' | 'SOS' | 'SRD' | 'STD' | 'SZL' | 'THB' | 'TJS' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UZS' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XCD' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMW', required
      - `status` string, required — The status of the payment within the payment provider. This can be very different from a payment provider to another.
      - `payment_status` 'succeeded' | 'failed' | 'pending' | 'processing', required — The normalized payment status by Lago.
      - `type` 'manual' | 'provider', required — The type of payment.
      - `reference` string, required — Reference for the payment.
      - `payment_provider_code` string, required — Code of the payment provider
      - `payment_provider_type` 'adyen' | 'cashfree' | 'gocardless' | 'stripe' | 'flutterwave' | 'moneyhash', required — The type of payment provider
      - `external_payment_id` string, nullable, required — DEPRECATED: use provider_payment_id
      - `provider_payment_id` string, nullable, required — Unique identifier of the payment within the payment provider (if applicable).
      - `provider_customer_id` string, required — Unique identifier of the customer within the payment provider
      - `payment_method_id` string, uuid, nullable — The unique identifier of the payment method used for this payment.
      - `next_action` object, required — The next action to be taken by the customer to complete the payment. Should usually be empty, except when receiving the `payment.requires_action` webhook.
      - `created_at` string, date-time, required — Timestamp when the payment was created in Lago's database, not on the payment provider.
  - `meta` PaginationMeta, required
    - `current_page` integer, required — Current page.
    - `next_page` integer, nullable — Next page.
    - `prev_page` integer, nullable — Previous page.
    - `total_pages` integer, required — Total number of pages.
    - `total_count` integer, required — Total number of records.

## Other responses

- `401` — Unauthorized error

---

[API](https://skmtc.dev/getlago/apis/lago-api-documentation.md) · [All operations](https://skmtc.dev/getlago/apis/lago-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getlago/lago-api-documentation/revisions/6e969ef3bb45/schema)