get
https://api.staging.bancocdc.com.br/transactions/p2p/batch//details/
Returns a paginated list of P2P batches
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Retrieves all P2P batches.
Each batch represents a bulk P2P transfer request previously created via POST /transactions/p2p/batch/{bank_account_uuid}.
Query parameters
| Param | Type | Default | Description |
|---|---|---|---|
limit | integer | 1000 | Records per page. Max 10000. |
page | integer | 1 | Page number (1-based). |
initial_date | string | — | YYYY-MM-DD or YYYY-MM-DD HH:MM:SS. Filter by created_at. |
final_date | string | — | Same format as initial_date. |
search | string | — | Free-text search (LIKE) over batch description and code. |
code_status | integer | — | Filter by transaction status code. See table below. |
bank_account_uuid | UUID | — | Restrict to batches whose items belong to the given origin account. |
Status codes (code_status)
code_status)| Code | Status |
|---|---|
| 1 | IN_PROCESS |
| 2 | APPROVED |
| 3 | CANCELED |
| 4 | EXPIRED |
| 5 | UNDER_REVIEW |
| 6 | PENDING |
Success response — 200 OK
200 OK{
"return": true,
"message": "success",
"data": {
"code": "772732a5-3d8c-4c8f-83f8-dfbf43dac5c6",
"item_status": "APPROVED",
"code_item_status": 2,
"reason": "example",
"description": "example item",
"amount": 100.00,
"origin_account": "4700000",
"receiver_account": "0770000",
"transaction_code_payer": "ccb776da-7d1d-476f-8b3d-5f351a060429",
"transaction_code_receiver": "7a8a6657-faba-4d8f-a064-0772405d27d9"
}
}
Field reference
| Field | Type | Description |
|---|---|---|
| code | UUID | Item identifier. |
| item_status | string | Human-readable status of the item. See status codes. |
| code_item_status | integer | Numeric status code matching the table above. |
| reason | string | Failure reason returned by the processing system. Empty when the item succeeded. |
| description | string | Optional description set on the item at creation. Empty string when not provided. |
| amount | number (BRL) | Transfer amount for this item. |
| origin_account | string | Account number that originated the transfer. |
| receiver_account | string | Account number that received the transfer. |
| transaction_code_payer | string | Transaction identifier on the payer side. |
| transaction_code_receiver | string | null |
Error responses
| Status | message | When |
|---|---|---|
400 | batch not found | No batches match the filters. |
400 | statement query with limit below \1` or over `10000` registries per page is not allowed` | limit > 10000. |
406 | bank account not found | bank_account_uuid does not belong to the company. |
401 | — | Missing/invalid Bearer token. |