---
name: globalrules-api.onrender.com
description: globalrules-api.onrender.com exposes a single endpoint that returns a list of countries supported by the Global Rules API, each with an ISO 2-letter code, a display name, and a timestamp indicating when the list was last updated. It serves as a reference data source for country enumeration within the Global Rules platform.
host: globalrules-api.onrender.com
---

# globalrules-api.onrender.com

This host is a narrow reference-data service tied to the Global Rules platform. It serves agents or applications that need to know which countries the platform recognizes, providing stable country codes and names alongside a cache-invalidation timestamp. It does not offer general-purpose country metadata and is not affiliated with broader geographic or geopolitical data providers.

## When to use this host

Use this host when an agent needs to retrieve the exact set of countries recognized by the Global Rules platform — for example, to populate a country selector, validate a user-supplied country code against platform support, or check whether the reference list has changed since a prior fetch via the updated timestamp. Do not use it for rich country metadata such as currencies, dialing codes, capitals, or geographic coordinates; use a dedicated country-info API (e.g., RestCountries) instead. Do not use it for real-time IP geolocation or user location detection. Because this host has only one skill with no inputs, there is no benefit to chaining it with other skills on this host.

## Capabilities

### Country Reference Data

Returns the canonical list of platform-supported countries with ISO 2-letter codes, display names, and an updated timestamp suitable for dropdown population, input validation, and cache invalidation.

- **`fetch-supported-countries`** — Returns a list of supported countries with ISO 2-letter codes and display names, plus an updated timestamp, from the Global Rules API.

## Skill reference

### `fetch-supported-countries`

**Global Rules Countries API** — Returns a list of supported countries with ISO 2-letter codes and display names, plus an updated timestamp, from the Global Rules API.

*Use when:* Use when an agent needs a canonical list of supported country codes and names to populate dropdowns, validate user input, or synchronize country reference data; the updated field can be used for cache invalidation.

*Not for:* Do not use for detailed country metadata such as currencies, phone codes, or geographic data; use a dedicated country-info API instead. Not suitable for real-time geolocation lookups.

**Returns:** Returns a JSON object with a countries array of ~100 entries each containing a two-letter code and name, plus an updated date string.

**Example:** `GET https://globalrules-api.onrender.com/api/v1/countries`

---