Get All Counterparties
GET/v1/crossborder/counterparties
Retrieve a list of all crossborder counterparties. Optional filter parameters can be used to refine your search.
Request
Query Parameters
Default value: 1
Page number.
Possible values: <= 100
Default value: 20
Page size. Max size is 100.
Page sort attribute.
Possible values: [asc, desc]
Default value: asc
Page order.
Possible values: [NATURAL_PERSON, LEGAL_PERSON]
Filter by counterparty type.
Possible values: [US, BR, MX, AR, CO, CL, PE, EC, UY, PY]
Filter by country code.
Filter by nationality.
Possible values: [CPF, CNPJ, DNI, PASSPORT, RUT, RUC, CUIL, CUIT, RFC, CURP, CE, PAS, PP]
Filter by document type.
Possible values: [ACTIVE, INACTIVE, PENDING]
Filter by status.
Filter by name.
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
Counterparties returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
Page number.
Page size.
Page total.
Total of elements.
data object[]required
Counterparties data.
Counterparty ID.
Counterparty name.
Possible values: [NATURAL_PERSON, LEGAL_PERSON]
Counterparty type.
Possible values: [US, BR, MX, AR, CO, CL, PE, EC, UY, PY]
Country code.
Nationality.
Document number.
Possible values: [CPF, CNPJ, DNI, PASSPORT, RUT, RUC, CUIL, CUIT, RFC, CURP, CE, PAS, PP]
Document type.
Email address.
Birth date.
Issue date.
address objectrequired
Address ID.
Street line 1.
Street line 2.
City.
State.
Subdivision.
Postal code.
Possible values: [US, BR, MX, AR, CO, CL, PE, EC, UY, PY]
Country.
Possible values: [ACTIVE, INACTIVE, PENDING]
Counterparty status.
Counterparty created date.
Counterparty updated date.
{
"page": 1,
"page_size": 20,
"page_total": 20,
"total": 100,
"data": [
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"name": "John Doe",
"type": "NATURAL_PERSON",
"country": "US",
"nationality": "American",
"document": "12345678901",
"document_type": "CPF",
"email": "john.doe@example.com",
"birth_date": "1990-01-01",
"issue_date": "2020-01-01",
"address": {
"id": "8fc58500-b12e-49d7-892c-dfd704b94c2d",
"street_line_1": "123 Main Street",
"street_line_2": "Suite 500",
"city": "San Francisco",
"state": "CA",
"subdivision": "CA",
"postal_code": "94102",
"country": "US"
},
"status": "ACTIVE",
"created_at": "2026-01-23T18:06:53.181Z",
"updated_at": "2026-01-23T18:06:53.181Z"
}
]
}
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.