Getting Started
Countries

List countries

Changed on

Returns the countries 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.

Authentication

This endpoint accepts any one of the following token types:

  • Company-scoped access token (OAuth2AuthorizationCode) — obtained through the Authorization Code flow or the Refresh Token flow. See Authentication for partners.
  • Client credentials access token (OAuth2ClientCredentials) — obtained through the Client Credentials flow or the Refresh Token flow. See Authentication for partners.
  • Customer API token (CustomerAPIToken) — generated by the customer on their Integration Settings page. See Authorization for customers.

Scopes

CategoryRead only ScopeWrite only Scope (read access implicit)
Manage company resources (company_admin)View countries (country:read)-
get/v1/countries

Request

  • Base URL: https://gateway.remote.com
  • URL: https://gateway.remote.com/v1/countries
  • Auth: HTTP bearer and OAuth 2 (authorization code, authorization URL /auth/oauth2/authorize, token URL /auth/oauth2/token, scopes: https://gateway.remote.com/company.manage, country:read, company_admin, all:write, all:read) and OAuth 2 (client credentials, token URL /auth/oauth2/token, scopes: https://gateway.remote.com/company.manage, country:read, company_admin, all:write, all:read)

Headers

Authorizationstring required

This endpoint works with any of the access tokens provided. You can use an access token obtained through the Client Credentials flow, the Authorization Code flow, or the Refresh Token flow.

Response

Success

Example response

{
  "data": [
    {
      "alpha_2_code": "PT",
      "code": "PRT",
      "employment_agreement_preview_available": true,
      "eor_onboarding": true,
      "global_payroll_supported": true,
      "name": "Portugal",
      "region": "Europe",
      "subregion": "Southern Europe",
      "supported_json_schemas": [
        "additional_documents",
        "address_details",
        "administrative_details",
        "employment-basic-information",
        "bank_account_details",
        "contract_details",
        "emergency_contact"
      ]
    }
  ]
}

Changes

  • 51aa6655a32fRevision changes
    • info

      added the optional property // to the response with the status