---
title: "Get Countries"
method: GET
path: "/api/v1/meta/countries/options"
tags: ["Account Information", "Public API"]
---

# Get Countries

`GET /api/v1/meta/countries/options`

Returns a JSON array of every country in the catalog, or a single country object when `isoCode` is supplied. Each element has `id` (Country ID), `name` (Country Name), and `isoCode` (ISO 3166-1 alpha-2 code or null when unset).

OAuth Scopes: field, meta

## Query parameters

- `isoCode` string

## Response `200`

When `isoCode` is omitted: a JSON array of all country objects. When `isoCode` is provided: the matching country as a single object.

- union
  - CountrySchema[] — Top-level JSON array of country objects. The response is not wrapped in a parent object.
    - `id` integer — Internal country identifier. Use the same value as the `countryId` path parameter for Get States by Country ID (this endpoint returns JSON numbers, not stringified digits).
    - `name` string — Full display name of the country
    - `isoCode` string, nullable — ISO 3166-1 alpha-2 when defined. The `isoCode` key is always present; the value is JSON `null` when the country has no code set in data (not omitted).
  - CountrySchema — A country in the list returned by the Get Countries endpoint
    - `id` integer — Internal country identifier. Use the same value as the `countryId` path parameter for Get States by Country ID (this endpoint returns JSON numbers, not stringified digits).
    - `name` string — Full display name of the country
    - `isoCode` string, nullable — ISO 3166-1 alpha-2 when defined. The `isoCode` key is always present; the value is JSON `null` when the country has no code set in data (not omitted).

## Other responses

- `404` — No country found for the given `isoCode`.
- `422` — `isoCode` is present but malformed (not exactly two alpha characters).

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)