---
title: "Get All Provinces"
method: GET
path: "/api/v1/meta/provinces"
tags: ["Account Information", "Public API"]
---

# Get All Provinces

`GET /api/v1/meta/provinces`

Returns a flat list of all states and provinces across every country. Each entry includes a numeric ID, the countryId it belongs to, an abbreviation label (e.g. "UT"), an ISO 3166-2 code (e.g. "US-UT"), and a full name. Use the countryId field to filter client-side.

OAuth Scopes: meta

## Response `200`

Flat array of all states/provinces across all countries.

- object[]
  - `id` integer — State/province ID
  - `countryId` string — ID of the country this state/province belongs to
  - `label` string — State/province abbreviation (e.g. "UT")
  - `iso` string — ISO 3166-2 code (e.g. "US-UT")
  - `name` string — Full name of the state/province

---

[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/versions/19ebf391a399/schema)