> ## 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.

# Card countries

> GET /v1/card/countries - where a card payment can come from.

<Note>
  **This is a list of countries that are blocked, not a list of countries that are
  allowed.** The card rail publishes restrictions per currency rather than an
  allowlist, and we pass that through rather than inventing the inverse. An empty list
  means nothing is restricted for that currency, not that nothing is supported.
</Note>

Returns the countries card payments are accepted from. The set is narrower than
[`GET /v1/countries`](/api-reference/reference/countries) - a country can be fine
to onboard from while its card schemes are not supported - so check this one
before showing the card option to a user.

## Request

No parameters.

## Response

<ResponseField name="countries" type="array">
  ISO 3166-1 alpha-2 codes of countries whose cards are accepted.
</ResponseField>

<Note>
  The buyer's country comes from their card and billing address, not their IP. A
  supported country does not skip identity checks - a first-time buyer still
  verifies through the card partner's flow, see
  [`/v1/card/kyc-token`](/api-reference/card-kyc-token).
</Note>

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "countries": ["AT", "BE", "DE", "ES", "FR", "GB", "IT", "NL", "PL", "PT"]
  }
  ```
</ResponseExample>

The example shows a subset - the live response carries the full set.

## Errors

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