> ## Documentation Index
> Fetch the complete documentation index at: https://restcountries.francocarballar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Available Regions

> Retrieves a list of all available regions with country counts and subregions.



## OpenAPI

````yaml get /api/v1/regions
openapi: 3.0.3
info:
  title: REST Countries API (Hono)
  description: >-
    API para obtener información sobre países del mundo, construida con Hono y
    desplegada en Cloudflare Workers.
  version: 1.0.0
servers:
  - url: http://localhost:8787
    description: Servidor de desarrollo local
  - url: https://restcountries.mcp-blockchain-metadata.workers.dev
    description: Servidor de producción (Cloudflare Workers)
security: []
paths:
  /api/v1/regions:
    get:
      tags:
        - Regions (Regiones)
      summary: Obtener Regiones Disponibles
      description: >-
        Recupera una lista de todas las regiones disponibles con recuento de
        países y subregiones.
      responses:
        '200':
          description: Una lista de resúmenes de regiones.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/RegionSummary'
              example:
                - name: africa
                  countryCount: 59
                  subregions:
                    - Eastern Africa
                    - Middle Africa
                    - ...
                - name: americas
                  countryCount: 57
                  subregions:
                    - Caribbean
                    - Central America
                    - ...
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    RegionSummary:
      type: object
      properties:
        name:
          type: string
          description: Nombre normalizado de la región.
        countryCount:
          type: integer
          description: Número de países en la región.
        subregions:
          type: array
          items:
            type: string
          description: Lista ordenada de subregiones dentro de la región.
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            status:
              type: integer
              format: int32
              description: El código de estado HTTP.
            message:
              type: string
              description: Un mensaje de error legible por humanos.
  responses:
    InternalServerError:
      description: Internal Server Error - Ocurrió un error inesperado.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error:
              status: 500
              message: Ocurrió un error interno del servidor.

````