---
title: "List Country Regions"
method: GET
path: "/addresses/countries/{country_id}/regions"
tags: ["Addresses::Region"]
---

# List Country Regions

`GET /addresses/countries/{country_id}/regions`

## Request

- Base URL: `https://myworkspace.myclickfunnels.com/api/v2`
- URL: `https://myworkspace.myclickfunnels.com/api/v2/addresses/countries/{country_id}/regions`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://accounts.myclickfunnels.com/oauth/authorize`
    - Token URL: `https://accounts.myclickfunnels.com/oauth/token`
- TypeScript: <https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/docs/addresses/countries/:country_id/regions/get.ts> (a function with typed inputs; its response is checked against the schema)

List the regions (states/provinces) of a country. Use a region's `code` or `name` as the address `region` value. Many countries have no regions.

## Path parameters

- `country_id` string, required

## Response `200`

OK

- AddressesRegionAttributes[]
  - `code` string, nullable: Region/state code (e.g. "CA"). Pass this (or name) as the address region value.
  - `name` string: Region/state name (e.g. "California").
  - `localized_name` string: Region name localized to the request's locale.
  - `country_code` string: The country's ISO 3166-1 alpha-2 code.

## Other responses

- `401`: Unauthorized
- `404`: Not Found

## Changes

- **2026-11-03** `511d88b30aea`: 2 breaking, 2 info
  - the response property `items/code` became optional for the status `200`
  - the response property `items/name` became optional for the status `200`
  - added the optional property `hint` to the response with the `401` status
  - added the optional property `hint` to the response with the `404` status

[Operation history](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/changes/addresses/countries/:country_id/regions/get.md)

---

[API](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api.md) - [All operations](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/revisions/511d88b30aea?raw)
