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

# Countries

> GET /v1/countries - where users can be onboarded, at runtime.

Returns every country with whether users domiciled there can be onboarded. Read
it at runtime rather than hard-coding a list - eligibility follows sanctions
rules (OFAC, EU, UN, UK, and MAS) and the policies of the banking and payment
networks behind each rail, so it can change without an API version change.

The human-readable version, including the excluded industries that apply
regardless of country, is on [Coverage](/coverage).

## Request

No parameters.

## Response

<ResponseField name="countries" type="array">
  One entry per ISO 3166-1 country.

  <Expandable title="countries[]">
    <ResponseField name="code" type="string">
      ISO 3166-1 alpha-2 country code.
    </ResponseField>

    <ResponseField name="name" type="string">
      The country's English name.
    </ResponseField>

    <ResponseField name="supported" type="boolean">
      Whether individuals and businesses domiciled in, operating from, or
      primarily owned by people in this country can be onboarded.
    </ResponseField>
  </Expandable>
</ResponseField>

<Note>
  `supported: true` is about the country, not the person. Onboarding still runs
  identity and compliance checks per user - see [Rheon ID](/rheon-id) - and some
  industries are excluded wherever they are based.
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl "$RHEON_API/v1/countries" \
    -H "Authorization: Bearer $RHEON_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "countries": [
      { "code": "DE", "name": "Germany", "supported": true },
      { "code": "PL", "name": "Poland", "supported": true },
      { "code": "US", "name": "United States", "supported": true },
      { "code": "IR", "name": "Iran", "supported": false },
      { "code": "KP", "name": "North Korea", "supported": false }
    ]
  }
  ```
</ResponseExample>

## Errors

| HTTP | `code`         | When                                    |
| ---- | -------------- | --------------------------------------- |
| 401  | `unauthorized` | Missing, malformed, or unknown API key. |
| 429  | `rate_limited` | Over your key's rate limit.             |
| 500  | `internal`     | Unexpected server error.                |