List Bank Billet Deposit Batch Items
GETTag: api-baas-get-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./v1/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.
UUID (v4) of the product that the request should use. Send it explicitly when the authenticated user has more than one product or when the integration must select a specific product. If omitted and the endpoint does not require it, the API uses the authenticated user's default product.
UUID (v4) of the user on whose behalf the request should run within the selected product. If omitted, the request runs as the authenticated user. Requires x-product-uuid.
Responses
- 200
- 400
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-04-02",
"banking_billet_pix_deposit_batch_id": "295564a9-c5fd-4e73-9abb-72e0383f2dfb",
"created_at": "2026-03-26T14:02:58.324Z",
"updated_at": "2026-03-26T14:02:58.324Z"
}
]
}
If any required params are missing or has invalid format or type.