Get Client by ID
GET/v1/crossborder/clients/:id
Retrieve detailed information about a specific crossborder client by providing the client ID.
Request
Path Parameters
Unique identifier (UUID) of the client to retrieve.
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
- 404
Client returned successfully.
- application/json
- Schema
- Example (from schema)
Schema
Unique identifier (UUID) of the client.
Full name of the client. For legal entities, the name field corresponds to the legal name.
Possible values: [NATURAL_PERSON, LEGAL_PERSON]
Type of client entity. NATURAL_PERSON for individuals, LEGAL_PERSON for companies or organizations.
Nationality of the client.
Official document number used for identification.
Possible values: [DRIVERS_LICENSE, IDENTITY_CARD, PASSPORT, OTHERS]
Type of identification document.
Email address of the client.
Date of birth of the client. Format: YYYY-MM-DD.
Date when the identification document was issued. Format: YYYY-MM-DD.
Country where the identification document was issued.
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]
Current status of the client.
Client created date.
Client updated date.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"name": "John Doe",
"type": "NATURAL_PERSON",
"nationality": "American",
"document": "12345678901",
"document_type": "PASSPORT",
"email": "john.doe@example.com",
"birth_date": "1990-01-01",
"issue_date": "2020-01-01",
"issuing_country": "USA",
"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-02-13T19:26:56.475Z",
"updated_at": "2026-02-13T19:26:56.475Z"
}
If any required params are missing or has invalid format or type.
Client not found.