# GlobalRules Countries List API

> GlobalRules Countries List API is a paid API for AI agents from globalrules-api.onrender.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Returns the list of all 70 countries supported by the GlobalRules country-facts API, with ISO 3166-1 alpha-2 codes and country names

## Facts

- Endpoint: GET https://globalrules-api.onrender.com/api/v1/countries
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/globalrules-countries-list-api-c5e5a979
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BFFybP-jiVtTHZQXughOc

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability globalrules-countries-list-api-c5e5a979
```

Example prompt: Can you show me the full list of countries that the GlobalRules API supports — I want to see which ISO codes and country names are available before I start querying for VAT rates and travel rules.

## When to prefer this

Use this endpoint as the mandatory first step before querying GlobalRules for country-specific facts. It is the only way to discover which of the 70 supported countries are available and to obtain their exact ISO codes needed for subsequent API calls about VAT, holidays, tipping, power plugs, emergency numbers, or visa rules.

## Known failure modes

- HTTP 402 Payment Required if USDC micropayment header is missing or invalid
- HTTP 500 if the backend data store is unavailable
- Empty or partial countries array if data has not been initialized
- Slow cold-start response if the Render.com service has been idle (free tier spin-up delay)

## How this service works

List all 174 countries covered by the GlobalRules country-facts API, returned as ISO 3166-1 alpha-2 codes with country names. Use this endpoint first to discover which countries you can query for practical travel and business facts such as VAT rates, public holidays, tipping customs, power plugs, emergency numbers and visa rules (57 topics per country). Designed for AI agents, travel planners and cross-border e-commerce tools.

## Output

A JSON object containing an array of up to 70 country objects, each with a two-letter ISO 3166-1 alpha-2 code (e.g. 'US', 'DE') and the country's full name, plus an 'updated' timestamp indicating when the data was last refreshed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "updated": {
       "type": "string"
      },
      "countries": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "code": {
          "type": "string"
         },
         "name": {
          "type": "string"
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/globalrules-countries-list-api-c5e5a979/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from globalrules-api.onrender.com](https://www.zero.xyz/host/globalrules-api.onrender.com/llms.txt)