Core Resources
Payment Methods
Money Management
Products
Checkout
Payment Links
Billing
Capital
Connect
Fraud
Issuing
Terminal
Treasury
Payment Records
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Forwarding
Webhooks

List all payments for an invoice 

Billing
Invoice Payment
List all payments for an invoice

When retrieving an invoice, there is an includable payments property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of payments.

Parameters

  • invoicestring

    The identifier of the invoice whose payments to return.

  • paymentobject

    The payment details of the invoice payments to return.

    • payment.typeenumRequired

      Only return invoice payments associated by this payment type.

      Possible enum values
      payment_intent

      Indicates that a PaymentIntent object is being associated with this invoice payment.

      payment_record

      Indicates that an PaymentRecord object is being associated with this invoice payment.

    • payment.payment_intentstring

      Only return invoice payments associated by this payment intent ID.

  • statusenum

    The status of the invoice payments to return.

    Possible enum values
    canceled

    The payment has been canceled; it will not be credited to the invoice.

    open

    The payment is incomplete and isn’t credited to the invoice. More fine-grained information available on the payment intent

    paid

    The payment is complete and has been credited to the invoice.

More parameters

  • ending_beforestring

    A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.

  • limitinteger

    A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.

  • starting_afterstring

    A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.

Returns

A dictionary with a data property that contains an array of up to limit invoice payments, starting after invoice payment starting_after. Each entry in the array is a separate invoice_payment object. If no more invoice payments are available, the resulting array will be empty.

GET /v1/invoice_payments
curl -G https://api.stripe.com/v1/invoice_payments \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -H "Stripe-Version: 2025-03-31.preview" \
  -d replaceMe="REPLACE ME"
Response
{
  "replaceMe": "REPLACE ME"
}