Management
Batch Get Countries
Retrieve country codes for multiple wallet addresses in a single request
POST
/
customers
/
api
/
manage
/
countries
/
batch
curl -X POST "https://api.trusset.org/customers/api/manage/countries/batch" \
-H "Content-Type: application/json" \
-H "X-API-Key: trusset_abc123xy_secret..." \
-d '{
"addresses": [
"0xAbC123dEf456789012345678901234567890AbCd",
"0x1234567890abcdef1234567890abcdef12345678"
]
}'
const response = await fetch(
'https://api.trusset.org/customers/api/manage/countries/batch',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
body: JSON.stringify({
addresses: [
'0xAbC123dEf456789012345678901234567890AbCd',
'0x1234567890abcdef1234567890abcdef12345678'
]
})
}
);
const { data: countries } = await response.json();
{
"success": true,
"data": {
"0xAbC123dEf456789012345678901234567890AbCd": "DE",
"0x1234567890abcdef1234567890abcdef12345678": "FR"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
{
"success": false,
"error": {
"code": "INVALID_INPUT",
"message": "Provide 1-500 addresses"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
Given an array of wallet addresses, returns the registered country code for each address. Useful for bulk compliance checks before processing transfers or trades.
Request Body
string[]
required
Array of Ethereum wallet addresses. Minimum 1, maximum 500 entries.
Response Fields
boolean
Request status
object
Map of wallet addresses to their country codes. Addresses not found in the instance are omitted from the result.
curl -X POST "https://api.trusset.org/customers/api/manage/countries/batch" \
-H "Content-Type: application/json" \
-H "X-API-Key: trusset_abc123xy_secret..." \
-d '{
"addresses": [
"0xAbC123dEf456789012345678901234567890AbCd",
"0x1234567890abcdef1234567890abcdef12345678"
]
}'
const response = await fetch(
'https://api.trusset.org/customers/api/manage/countries/batch',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
body: JSON.stringify({
addresses: [
'0xAbC123dEf456789012345678901234567890AbCd',
'0x1234567890abcdef1234567890abcdef12345678'
]
})
}
);
const { data: countries } = await response.json();
{
"success": true,
"data": {
"0xAbC123dEf456789012345678901234567890AbCd": "DE",
"0x1234567890abcdef1234567890abcdef12345678": "FR"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
{
"success": false,
"error": {
"code": "INVALID_INPUT",
"message": "Provide 1-500 addresses"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
⌘I
curl -X POST "https://api.trusset.org/customers/api/manage/countries/batch" \
-H "Content-Type: application/json" \
-H "X-API-Key: trusset_abc123xy_secret..." \
-d '{
"addresses": [
"0xAbC123dEf456789012345678901234567890AbCd",
"0x1234567890abcdef1234567890abcdef12345678"
]
}'
const response = await fetch(
'https://api.trusset.org/customers/api/manage/countries/batch',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
body: JSON.stringify({
addresses: [
'0xAbC123dEf456789012345678901234567890AbCd',
'0x1234567890abcdef1234567890abcdef12345678'
]
})
}
);
const { data: countries } = await response.json();
{
"success": true,
"data": {
"0xAbC123dEf456789012345678901234567890AbCd": "DE",
"0x1234567890abcdef1234567890abcdef12345678": "FR"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
{
"success": false,
"error": {
"code": "INVALID_INPUT",
"message": "Provide 1-500 addresses"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}