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

# List

> List every available region per primitive: compute regions for always-on apps, storage placement areas, database regions, and the global edge placement scale-to-zero apps run on.



## OpenAPI

````yaml /openapi.json get /v1/regions
openapi: 3.1.0
info:
  title: Korve API
  version: 0.1.0
  description: >-
    Typed control plane for deploying applications and explicitly provisioning
    their managed infrastructure.
servers:
  - url: https://api.korve.dev
security: []
paths:
  /v1/regions:
    get:
      tags:
        - regions
      summary: List
      description: >-
        List every available region per primitive: compute regions for always-on
        apps, storage placement areas, database regions, and the global edge
        placement scale-to-zero apps run on.
      operationId: regions.list
      parameters: []
      responses:
        '200':
          description: The region catalogs.
          content:
            application/json:
              schema:
                type: object
                properties:
                  compute:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Region id used in create requests (e.g. "fra").
                        name:
                          type: string
                          description: >-
                            Customer-facing geographic area name (e.g. "US
                            East").
                        code:
                          type: string
                          description: >-
                            Physical provider region or location-hint code shown
                            in the UI.
                        city:
                          type: string
                          description: Display city or area name.
                        country:
                          type: string
                        countryCode:
                          type: string
                          description: ISO 3166 alpha-2 code.
                        flag:
                          type: string
                          description: Flag emoji derived from the country code.
                        continent:
                          type: string
                      required:
                        - id
                        - name
                        - code
                        - city
                        - country
                        - countryCode
                        - flag
                        - continent
                  storage:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Region id used in create requests (e.g. "fra").
                        name:
                          type: string
                          description: >-
                            Customer-facing geographic area name (e.g. "US
                            East").
                        code:
                          type: string
                          description: >-
                            Physical provider region or location-hint code shown
                            in the UI.
                        city:
                          type: string
                          description: Display city or area name.
                        country:
                          type: string
                        countryCode:
                          type: string
                          description: ISO 3166 alpha-2 code.
                        flag:
                          type: string
                          description: Flag emoji derived from the country code.
                        continent:
                          type: string
                      required:
                        - id
                        - name
                        - code
                        - city
                        - country
                        - countryCode
                        - flag
                        - continent
                  database:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Region id used in create requests (e.g. "fra").
                        name:
                          type: string
                          description: >-
                            Customer-facing geographic area name (e.g. "US
                            East").
                        code:
                          type: string
                          description: >-
                            Physical provider region or location-hint code shown
                            in the UI.
                        city:
                          type: string
                          description: Display city or area name.
                        country:
                          type: string
                        countryCode:
                          type: string
                          description: ISO 3166 alpha-2 code.
                        flag:
                          type: string
                          description: Flag emoji derived from the country code.
                        continent:
                          type: string
                      required:
                        - id
                        - name
                        - code
                        - city
                        - country
                        - countryCode
                        - flag
                        - continent
                  global:
                    type: object
                    description: >-
                      The regionless placement scale-to-zero apps run on — every
                      edge location at once, so there is no continent and the
                      flag is a globe.
                    properties:
                      id:
                        type: string
                        description: Always "global".
                      name:
                        type: string
                        description: Always "Global".
                      code:
                        type: string
                        description: Always "global".
                      city:
                        type: string
                      country:
                        type: string
                      countryCode:
                        type: string
                        description: Empty — the globe has no country.
                      flag:
                        type: string
                    required:
                      - id
                      - name
                      - code
                      - city
                      - country
                      - countryCode
                      - flag
                required:
                  - compute
                  - storage
                  - database
                  - global
      security: []

````