> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Batch Get Countries

> Retrieve country codes for multiple wallet addresses in a single request

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

<ParamField body="addresses" type="string[]" required>
  Array of Ethereum wallet addresses. Minimum 1, maximum 500 entries.
</ParamField>

## Response Fields

<ResponseField name="success" type="boolean">Request status</ResponseField>

<ResponseField name="data" type="object">
  Map of wallet addresses to their country codes. Addresses not found in the instance are omitted from the result.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  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"
      ]
    }'
  ```

  ```typescript TypeScript theme={null}
  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();
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "0xAbC123dEf456789012345678901234567890AbCd": "DE",
      "0x1234567890abcdef1234567890abcdef12345678": "FR"
    },
    "metadata": {
      "requestId": "550e8400-e29b-41d4-a716-446655440000",
      "timestamp": "2025-06-15T12:00:00.000Z"
    }
  }
  ```

  ```json Error - Invalid Input theme={null}
  {
    "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"
    }
  }
  ```
</ResponseExample>