List payments with summary data

get

https://api-sandbox.asaas.com/v3/lean/payments

Lists the account's payments according to the filters provided and returns summary data for each record.

Use this operation when your integration needs to query payments without receiving the full object returned by the standard list. Endpoints with summary data have a lighter response payload and respond faster than the standard payment endpoints.

The response follows the API listing and pagination pattern.

If you need the full data of each payment, use List payments.

📘
Tracking changes
To track payment status changes, use Webhooks instead of repeatedly querying this endpoint.
Use this GET for one-off queries, recovery, or reconciliation.
See the Webhook events for payments.

Related content

Guides

Introduction - Payments

Query Params

offset

integer

List starting element

limit

integer

≤ 100

Number of list elements (max: 100)

customer

string

Filter by unique customer identifier

customerGroupName

string

Filter by customer group name

billingType

string

enum

Filter by billing type

Allowed:

status

string

enum

Filter by status

subscription

string

Filter by unique subscription identifier

installment

string

Filter by unique installment identifier

externalReference

string

Filter by your system identifier

paymentDate

string

Filter by payment date

invoiceStatus

string

enum

Filter to return charges that have or do not have an invoice

Allowed:

estimatedCreditDate

string

Filter by estimated credit date

pixQrCodeId

string

Filter receipts originating from a static QrCode using the id generated when the QrCode was created

anticipated

boolean

Filter anticipated charges or not

anticipable

boolean

Filter anticipable charges or not

dateCreated[ge]

string

Filter from initial creation date

dateCreated[le]

string

Filter to final creation date

paymentDate[ge]

string

Filter from initial payment date

paymentDate[le]

string

Filter to final payment date

estimatedCreditDate[ge]

string

Filter from estimated initial credit date

estimatedCreditDate[le]

string

Filter to estimated end credit date

dueDate[ge]

string

Filter from initial due date

dueDate[le]

string

Filter by final due date

user

string

Filter by the email address of the user who created the payment.

checkoutSession

string

Filter by checkout unique identifier

Responses

403

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

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Tracking changes

Related content

Guides

200Ok

400Bad Request

401Unauthorized