Get All Counterparty Accounts
GET/v1/crossborder/counterparties/:id/accounts
Retrieve a list of all bank accounts associated with a specific crossborder counterparty. Optional filter parameters can be used to refine your search.
Request
Path Parameters
Unique identifier (UUID) of the counterparty to list accounts for.
Query Parameters
Default value: 1
Page number.
Possible values: <= 100
Default value: 20
Page size. Max size is 100.
Possible values: [created_at, account_number]
Page sort attribute.
Possible values: [asc, desc]
Default value: asc
Page order.
Possible values: [USD, BRL, MXN, ARS, COP, CLP, PEN, ECU, UYU, PYG]
Filter by currency symbol.
Header Parameters
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
Counterparty accounts returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
Page number.
Page size.
Page total.
Total of elements.
data object[]required
Counterparty accounts data.
Unique identifier (UUID) of the account.
Unique identifier (UUID) of the user.
Unique identifier (UUID) of the counterparty.
Country code.
Currency symbol.
Account type.
Bank account number.
Branch number.
Bank name.
Bank code.
Bank code type.
Possible values: [ACTIVE, INACTIVE, PENDING]
Account status.
Account created date.
Account updated date.
{
"page": 1,
"page_size": 20,
"page_total": 20,
"total": 100,
"data": [
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"user_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"counterparty_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"country": "US",
"currency_symbol": "USD",
"account_type": "CHECKING",
"account_number": "12345678",
"branch": "0001",
"bank_name": "Bank of America",
"bank_code": "BOFAUS3N",
"bank_code_type": "BIC",
"status": "PENDING",
"created_at": "2026-02-13T19:26:56.571Z",
"updated_at": "2026-02-13T19:26:56.571Z"
}
]
}
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.