Countries

curl "$RHEON_API/v1/countries" \
  -H "Authorization: Bearer $RHEON_API_KEY"

{
  "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 }
  ]
}

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.

Request

No parameters.

Response

array

One entry per ISO 3166-1 country.

Show countries[]

string

ISO 3166-1 alpha-2 country code.

string

The country’s English name.

boolean

Whether individuals and businesses domiciled in, operating from, or primarily owned by people in this country can be onboarded.

supported: true is about the country, not the person. Onboarding still runs identity and compliance checks per user - see Rheon ID - and some industries are excluded wherever they are based.

curl "$RHEON_API/v1/countries" \
  -H "Authorization: Bearer $RHEON_API_KEY"

{
  "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 }
  ]
}

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.

Getting started

Crypto deposits

Card payments

Bank transfers

Virtual accounts

Reference

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors