API Reference › Utilities › List of countries
List of countries
Retrieve the set of geographies you can target when scheduling monitors, expressed as ISO 3166-1 alpha-2 codes and optionally narrowed to a single AI provider.
GET https://api.cloro.cloud/v1/countries
Overview
This utility endpoint reports every country that cloro is able to run monitoring queries against. Each entry is a two-letter ISO 3166-1 alpha-2 code, the same identifier you pass when creating monitor tasks. Because coverage can differ from one AI provider to another, you may supply a model value to receive only the countries that are currently available for that provider. When the parameter is omitted, the full, provider-agnostic list is returned.
Query parameters
| Field | Type | Description |
|---|---|---|
model | string | Optional. Restricts the response to countries supported by a single AI provider. Omit it to list every supported country. Accepted values: aimode, aioverview, chatgpt, copilot, gemini, google, perplexity. |
No path parameters or request body are required. Authentication is provided through a Bearer token in the Authorization header.
Response fields
| Field | Type | Description |
|---|---|---|
(root) | array<string> | A flat JSON array of ISO 3166-1 alpha-2 country codes supported for the requested scope. |
Response example
[
"AF",
"AX",
"AL",
"DZ",
"AS",
"AD",
"AO",
"AR",
"AU",
"AT",
"US",
"GB"
]Notes
- The country list changes infrequently, so caching the result for roughly a day and refreshing on a schedule is usually sufficient.
- Validate user-supplied country codes against this list before submitting monitor tasks to avoid rejected requests.
- When targeting a specific provider, call the endpoint with the matching
modelvalue first, since a country valid for one provider may not be available for another. - An unrecognized
modelvalue returns a400response; handle it and fall back to the unfiltered list where appropriate. - Questions or coverage requests can be sent to [email protected].