Get Bank Billet Deposit Batch Item by ID
GETTag: api-paas-get-banking-billet-pix-deposit-batch-item-by-idDescription: Get a bank billet deposit batch item by its ID./banking/billet-pix-deposit-batch-items/:id
Request
Path Parameters
Batch item ID.
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 item returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
Bank billet deposit batch item ID.
Payer name.
Payer document (CPF/CNPJ).
Payer email.
Description.
Amount
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.
Banking billet pix deposit ID.
Barcode.
EMV code.
Creation date.
Update date.
{
"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",
"banking_billet_pix_deposit_id": "295564a9-c5fd-4e73-9abb-72e0383f2dfb",
"barcode": "00190500954014481606906809350314337370000000100",
"emv": "00020126360014BR.GOV.BCB.PIX0114+5511999999999520400005303986540610.005802BR5909Person Name6009Sao Paulo62070503***6304",
"created_at": "2025-12-26T17:17:50.629Z",
"updated_at": "2025-12-26T17:17:50.629Z"
}
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.