List Bank Billet Deposit Batch Items
GETTag: api-paas-get-all-banking-billet-pix-deposit-batch-item-by-batch-idDescription: Retrieve a list of bank billet deposit batch items by batch ID. Use optional filter parameters to refine your search./banking/billet-pix-deposit-batch-items
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.
Batch ID.
Possible values: [BILLET_WAITING, BILLET_CREATED, BILLET_FAILED]
Status.
Start date of the created at period in the format YYYY-MM-DD.
End date of the created at period in the format YYYY-MM-DD.
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 billet batch items returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
Page number.
Page size.
Page total.
Total of elements.
data object[]required
Bank billet pix deposit batch items data.
Bank billet deposit batch item ID.
Payer name.
Payer document (CPF/CNPJ).
Payer email.
Description.
Amount in cents
Interest percentage value.
Fine value in cents.
Discount value in cents.
Possible values: [BILLET_WAITING, BILLET_CREATED, BILLET_FAILED]
Status.
Possible values: [SCHEDULED, SENT, FAILED]
Email status.
Due date.
Bank billet deposit batch ID.
Creation date.
Update date.
{
"page": 1,
"page_size": 20,
"page_total": 20,
"total": 100,
"data": [
{
"id": "295564a9-c5fd-4e73-9abb-72e0383f2dfb",
"payer_name": "string",
"payer_document": "12345678901",
"payer_email": "string",
"description": "Payment for service",
"amount": 10000,
"interest_perc_value": 2.5,
"fine_value": 500,
"discount_value": 1000,
"status": "BILLET_WAITING",
"email_status": "SCHEDULED",
"due_date": "2026-01-02",
"banking_billet_pix_deposit_batch_id": "295564a9-c5fd-4e73-9abb-72e0383f2dfb",
"created_at": "2025-12-26T17:17:50.628Z",
"updated_at": "2025-12-26T17:17:50.628Z"
}
]
}
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.