---
title: "List countries"
method: GET
path: "/v1/countries"
tags: ["Countries"]
---

# List countries

`GET /v1/countries`

Returns a list of all countries that are supported by Remote API alphabetically ordered.
The supported list accounts for creating employment with basic information and it does not imply fully onboarding employment via JSON Schema.
The countries present in the list are the ones where creating a company is allowed.


## Scopes

| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage company resources (`company_admin`) | View countries (`country:read`) | - |

## Headers

- `Authorization` string, required

## Response `200`

Success

- CountriesResponse — List of countries supported by Remote API
  - `data` Country[]
    - `alpha_2_code` string, required — The ISO 3166-1 alpha-2 country code (e.g., "PT").
    - `code` string, required — The ISO 3166-1 alpha-3 country code (e.g., "PRT"). This is the primary code used across the Remote API.
    - `contractor_products_available` string[] — Contractor product names available for this country
    - `country_subdivisions` CountrySubdivision[], nullable — Administrative subdivisions of the country (e.g., states, provinces, districts). Null if the country has no subdivisions relevant to Remote's services.
      - `code` string — The ISO 3166-2 subdivision code (e.g., "PT-11" for Lisboa).
      - `name` string, required — The subdivision's name (e.g., "Lisboa", "California").
      - `subdivision_type` string — The type of subdivision (e.g., "District", "State", "Province").
    - `employment_agreement_preview_available` boolean — Whether an Employment Agreement preview is available for this country.
    - `eor_onboarding` boolean — Whether EOR (Employer of Record) onboarding is available in this country.
    - `locked_benefits` string — When benefit plan selections become locked for this country (e.g., "after_first_hire" means benefits cannot be changed after the first employee is hired).
    - `name` string, required — The country's full English name.
    - `region` string — The geographic region the country belongs to (e.g., "Europe", "Asia", "Americas").
    - `subregion` string, nullable — The geographic subregion (e.g., "Southern Europe", "Southeast Asia"). Null for some countries.
    - `supported_json_schemas` string[] — The list of JSON schema form names available for this country (e.g., "address_details", "contract_details"). Use these with the Show form schema endpoint to get country-specific field requirements.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `429` — Too many requests

---

[API](https://skmtc.net/remote-com/apis/remote.md) · [All operations](https://skmtc.net/remote-com/apis/remote/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/remote-com/remote/revisions/7e6a0c61ac82/schema)