List payments of a subscription

Lists the payments already generated by a subscription.

Use this operation to retrieve the existing payments of the recurrence, including their IDs and current statuses. Future payments that have not been generated yet do not appear in the response.

Each payment has its own ID, status, and financial cycle.

📘

Tracking payments

To track the creation of new payments and status changes, use Webhooks instead of repeatedly querying this endpoint.

Use this GET for one-off queries, recovery, or reconciliation.

The PAYMENT_CREATED event includes the subscription field, which identifies the subscription that originated the payment.

See the Webhook events for payments.

Related content

Guides

Path Params
string
required

Unique subscription identifier in Asaas

Query Params
string
enum

Filter by payment status

Responses

403

Forbidden. Occurs when the request body is filled, GET method calls must have an empty body.

404

Not found

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json