List Pix recurrences
GETTag: api-paas-get-all-pix-recurrenceDescription: Retrieve a list of the user's pix recurrences. Use optional filter parameters to refine your search./pix/scheduled-payments/recurrence
Request
Query Parameters
Default value: 1
Page number.
Possible values: <= 100
Default value: 20
Page size. Max size is 100.
Possible values: [created_at
]
Page sort attribute.
Possible values: [asc
, desc
]
Default value: asc
Page order.
Header Parameters
Sender Wallet UUID (if empty, your default Wallet UUID will be settled)
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR
, en-US
]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
The product ID is a UUID (v4) used to identify the Z.ro product configuration.
The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.
Responses
- 200
- 400
- 401
- 422
The recurrences returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
Page number.
Page size.
Page total.
Total of elements.
data object[]required
Pix recurrence data
Recurrence ID.
Recurrence value.
Recurrence beneficiary name.
Possible values: [ACTIVE
, DEACTIVATED
]
Recurrence state.
Possible values: [WEEKLY
, MONTHLY
]
Recurrence frequency.
Possible values: [MONDAY
, TUESDAY
, WEDNESDAY
, THURSDAY
, FRIDAY
, SATURDAY
, SUNDAY
]
Recurrence day of the week.
Recurrence day of the month.
Recurrence end date.
Recurrence first payment date.
Recurrence last payment date.
Recurrence creation date.
Recurrence update date.
{
"page": 1,
"page_size": 20,
"page_total": 20,
"total": 100,
"data": [
{
"id": "d1952c4b-9348-41ab-99a3-05b11459aded",
"value": 100,
"beneficiary_name": "John Doe.",
"state": "ACTIVE",
"frequency": "MONTHLY",
"day_of_the_week": "FRIDAY",
"day_of_the_month": 10,
"end_date": "2025-04-25T17:37:08.398Z",
"first_payment_date": "2025-04-25T17:37:08.398Z",
"last_payment_date": "2025-04-25T17:37:08.398Z",
"created_at": "2025-04-25T17:37:08.398Z",
"updated_at": "2025-04-25T17:37:08.398Z"
}
]
}
If any required params are missing or has invalid format or type.
User authentication failed.
If any required params are missing or has invalid format or type.