# Get allowed exchanges per country

`GET https://api.cryptohopper.com/v1/platform/country_allow_exchange`

Part of [Platform](https://www.cryptohopper.com/api-documentation/api-reference/platform.md) in the Cryptohopper API reference.

Returns, per two-letter country code, the exchanges allowed for users by residence and by nationality, plus the country detected for the request.

Needs a valid access token; no scope is checked. ip_country comes from the CF-IPCountry request header and is null when that header is missing.

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/platform/country_allow_exchange" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": {
        "country_settings": {
            "NL": {
                "residence": [
                    "binance",
                    "bitvavo"
                ],
                "nationality": [
                    "binance",
                    "bitvavo"
                ]
            }
        },
        "ip_country": "NL"
    }
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.