List Bank Billet Deposits
GETTag: api-paas-get-banking-billet-pix-depositDescription: Retrieve a list of bank billet deposits. Use optional filter parameters to refine your search./banking/billet-pix-deposit
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.
Possible values: [CREATED_PENDING
, CREATED_WAITING
, CREATED_CONFIRMED
, CREATED_FAILED
, RECEIVED
]
State.
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 deposits 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 data.
Bank billet deposit ID.
Bank billet deposit operation ID.
Possible values: [CREATED_PENDING
, CREATED_WAITING
, CREATED_CONFIRMED
, CREATED_FAILED
, RECEIVED
]
Bank billet deposit state.
Amount specified in Brazilian Real (R$) cents.
Bank billet pix deposit interest value in percentage.
Bank billet pix deposit fine (converted to integer amount).
Bank billet pix deposit discount value (converted to integer amount).
Due date.
Limit due date.
Barcode.
Typeable line.
Pix key.
Pix key id.
Emv.
Transaction tag.
Bank billet pix deposit file ID.
Whether the billet PDF is personalized or not.
Creation date.
Confirmation date.
{
"page": 1,
"page_size": 20,
"page_total": 20,
"total": 100,
"data": [
{
"id": "295564a9-c5fd-4e73-9abb-72e0383f2dfb",
"operation_id": "295564a9-c5fd-4e73-9abb-72e0383f2dfb",
"state": "CREATED_PENDING",
"amount": 1299,
"interest_perc_value": 1.01,
"fine_value": 202,
"discount_value": 1001,
"due_date": "2025-10-22T19:11:19.256Z",
"limit_due_date": "2025-10-22T19:11:19.256Z",
"barcode": "00000000000000000000000000000000000000000000",
"typeable_line": "00000000000000000000000000000000000000000000000",
"key": "cd71aa2d-757e-4ccc-aeef-1d2c1e00b49b",
"key_id": "cd71aa2d-757e-4ccc-aeef-1d2c1e00b49b",
"emv": "00020101021226910014br.gov.bcb.pix2569bankaddress.com.br/pix/v2/cob/8b358702141e4162bd68eedfe7fb45f4520400005303986540523.005802BR5924USER",
"transaction_tag": "PIXREC",
"file_id": "295564a9-c5fd-4e73-9abb-72e0383f2dfb",
"personalized": true,
"created_at": "2025-10-22T19:11:19.256Z",
"confirmed_at": "2025-10-22T19:11:19.256Z"
}
]
}
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.