{
  "openapi": "3.1.0",
  "info": {
    "title": "Regions API",
    "version": "1.0.0",
    "summary": "Every region of AWS, Azure, Google Cloud, Oracle, IBM and Alibaba, the data platforms that run inside them (Snowflake, Databricks, MongoDB Atlas and more), Cloudflare data centers, and Bedrock and Azure OpenAI model availability by region, from the providers’ own published lists",
    "description": "Every region of AWS, Azure, Google Cloud, Oracle, IBM and Alibaba, the data platforms that run inside them (Snowflake, Databricks, MongoDB Atlas and more), Cloudflare data centers, and Bedrock and Azure OpenAI model availability by region, from the providers’ own published lists. Refreshed weekly on Tuesdays at 10:00 UTC. Free to read; please cite \"Regions (regions.fru.dev)\" with a link. Responses are cached at the edge; keep to about 60 requests a minute. Guide: https://regions.fru.dev/agents",
    "contact": {
      "name": "fru.dev",
      "url": "https://fru.dev",
      "email": "fru.dev3@gmail.com"
    }
  },
  "externalDocs": {
    "description": "For AI agents",
    "url": "https://regions.fru.dev/agents"
  },
  "servers": [
    {
      "url": "https://regions.fru.dev"
    }
  ],
  "paths": {
    "/api/regions": {
      "get": {
        "operationId": "list_regions",
        "summary": "Cloud and data platform regions, filtered by provider, country or status",
        "description": "Cloud and data platform regions, filtered by provider, country or status. Returns regions with provider, code, name, location, country, metro, coordinates, launch year, availability zones, status and source URL.",
        "parameters": [
          {
            "name": "provider",
            "in": "query",
            "required": false,
            "description": "Provider id, e.g. aws, azure, gcp, oracle, snowflake",
            "schema": {
              "type": "string"
            },
            "example": "aws"
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "ISO country code, e.g. DE",
            "schema": {
              "type": "string"
            },
            "example": "DE"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "ga, preview or announced",
            "schema": {
              "type": "string",
              "enum": [
                "ga",
                "preview",
                "announced"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Items per page, 1 to 200",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 200
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip, for the next page",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "regions with provider, code, name, location, country, metro, coordinates, launch year, availability zones, status and source URL",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "regions": [
                    {
                      "id": "aws:eu-central-1",
                      "provider": "aws",
                      "code": "eu-central-1",
                      "name": "Europe (Frankfurt)",
                      "place": "Frankfurt",
                      "metro": "frankfurt",
                      "cc": "DE",
                      "lat": 50.1109,
                      "lon": 8.6821,
                      "precision": "provider",
                      "launched": "2014",
                      "azs": 3,
                      "status": "ga",
                      "sovereign": ""
                    },
                    {
                      "id": "aws:eusc-de-east-1",
                      "provider": "aws",
                      "code": "eusc-de-east-1",
                      "name": "AWS European Sovereign Cloud (Germany)",
                      "place": "Germany",
                      "metro": "berlin",
                      "cc": "DE",
                      "lat": 52.3667,
                      "lon": 13.4167,
                      "precision": "provider",
                      "launched": "2026",
                      "azs": 3,
                      "status": "ga",
                      "sovereign": "sovereign"
                    }
                  ],
                  "count": 2,
                  "total": 2,
                  "limit": 5,
                  "offset": 0,
                  "next": null,
                  "disclaimer": "From providers' published region lists. Check the provider before deploying."
                }
              }
            }
          }
        }
      }
    },
    "/api/regions/{provider}/{code}": {
      "get": {
        "operationId": "get_region",
        "summary": "One region with the AI models it serves",
        "description": "One region with the AI models it serves. Returns the region, its host region for a data platform, and the models served there with their mode.",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "description": "Provider id",
            "schema": {
              "type": "string"
            },
            "example": "aws"
          },
          {
            "name": "code",
            "in": "path",
            "required": true,
            "description": "Region code",
            "schema": {
              "type": "string"
            },
            "example": "eu-central-1"
          }
        ],
        "responses": {
          "200": {
            "description": "the region, its host region for a data platform, and the models served there with their mode",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "region": {
                    "id": "aws:eu-central-1",
                    "provider": "aws",
                    "code": "eu-central-1",
                    "name": "Europe (Frankfurt)",
                    "place": "Frankfurt",
                    "metro": "frankfurt",
                    "cc": "DE",
                    "lat": 50.1109,
                    "lon": 8.6821,
                    "precision": "provider",
                    "launched": "2014",
                    "azs": 3,
                    "status": "ga",
                    "sovereign": ""
                  },
                  "host": null,
                  "models": [
                    {
                      "platform": "bedrock",
                      "id": "amazon-nova-2-lite",
                      "name": "Nova 2 Lite",
                      "vendor": "Amazon",
                      "modes": [
                        "geo",
                        "global"
                      ]
                    },
                    {
                      "platform": "bedrock",
                      "id": "amazon-nova-lite",
                      "name": "Nova Lite",
                      "vendor": "Amazon",
                      "modes": [
                        "geo"
                      ]
                    }
                  ],
                  "disclaimer": "From providers' published region lists. Check the provider before deploying."
                }
              }
            }
          },
          "404": {
            "description": "Not found"
          }
        }
      }
    },
    "/api/models": {
      "get": {
        "operationId": "list_models",
        "summary": "AI models on Amazon Bedrock and Azure OpenAI with how many regions serve each",
        "description": "AI models on Amazon Bedrock and Azure OpenAI with how many regions serve each. Returns models with vendor and, per platform, the region count and modes (regional, geo, global).",
        "parameters": [
          {
            "name": "vendor",
            "in": "query",
            "required": false,
            "description": "Model vendor, e.g. Anthropic, OpenAI, Meta",
            "schema": {
              "type": "string"
            },
            "example": "Anthropic"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Items per page, 1 to 200",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 200
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip, for the next page",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "models with vendor and, per platform, the region count and modes (regional, geo, global)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "models": [
                    {
                      "id": "anthropic-claude-3-haiku",
                      "name": "Claude 3 Haiku",
                      "vendor": "Anthropic",
                      "platforms": [
                        {
                          "platform": "bedrock",
                          "regions": 11,
                          "modes": [
                            "geo",
                            "regional"
                          ]
                        }
                      ],
                      "regions": 11
                    },
                    {
                      "id": "anthropic-claude-3-sonnet",
                      "name": "Claude 3 Sonnet",
                      "vendor": "Anthropic",
                      "platforms": [
                        {
                          "platform": "bedrock",
                          "regions": 11,
                          "modes": [
                            "regional",
                            "geo"
                          ]
                        }
                      ],
                      "regions": 11
                    }
                  ],
                  "count": 3,
                  "total": 22,
                  "limit": 3,
                  "offset": 0,
                  "next": "/api/models?vendor=Anthropic&limit=3&offset=3"
                }
              }
            }
          }
        }
      }
    },
    "/api/models/{id}": {
      "get": {
        "operationId": "get_model",
        "summary": "The regions that serve one AI model",
        "description": "The regions that serve one AI model. Returns the model and one row per region with platform, region id, mode and status.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Model id from /api/models",
            "schema": {
              "type": "string"
            },
            "example": "anthropic-claude-sonnet-4-5"
          }
        ],
        "responses": {
          "200": {
            "description": "the model and one row per region with platform, region id, mode and status",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "model": {
                    "id": "anthropic-claude-sonnet-4-5",
                    "name": "Claude Sonnet 4.5",
                    "vendor": "Anthropic",
                    "platforms": [
                      {
                        "platform": "bedrock",
                        "regions": 35,
                        "modes": [
                          "geo",
                          "global"
                        ]
                      }
                    ],
                    "regions": 35
                  },
                  "regions": [
                    {
                      "platform": "bedrock",
                      "region": "aws:us-east-1",
                      "mode": "geo",
                      "status": "ga"
                    },
                    {
                      "platform": "bedrock",
                      "region": "aws:us-east-1",
                      "mode": "global",
                      "status": "ga"
                    }
                  ],
                  "count": 52
                }
              }
            }
          },
          "404": {
            "description": "Not found"
          }
        }
      }
    },
    "/api/search": {
      "get": {
        "operationId": "search",
        "summary": "Search providers, regions, models, countries and metros",
        "description": "Search providers, regions, models, countries and metros. Returns up to 20 ranked results with title, link and one line.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Region code, city, provider or model name",
            "schema": {
              "type": "string"
            },
            "example": "frankfurt"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Results, 1 to 20",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 20,
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "up to 20 ranked results with title, link and one line",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "q": "frankfurt",
                  "results": [
                    {
                      "id": "rg:aws:eu-central-1",
                      "group": "items",
                      "title": "AWS eu-central-1",
                      "subtitle": "Europe (Frankfurt) · Frankfurt, Germany",
                      "href": "/regions/aws/eu-central-1",
                      "keywords": [
                        "eu-central-1",
                        "Europe (Frankfurt)"
                      ],
                      "boost": 10,
                      "score": 985
                    },
                    {
                      "id": "rg:alibaba:eu-central-1",
                      "group": "items",
                      "title": "Alibaba eu-central-1",
                      "subtitle": "Germany (Frankfurt) · Frankfurt, Germany",
                      "href": "/regions/alibaba/eu-central-1",
                      "keywords": [
                        "eu-central-1",
                        "Germany (Frankfurt)"
                      ],
                      "boost": 10,
                      "score": 985
                    }
                  ]
                }
              }
            }
          }
        }
      }
    }
  }
}