---
title: "List All Locations"
method: GET
path: "/v1/locations"
tags: ["Locations"]
---

# List All Locations

`GET /v1/locations`

## Request

- Base URL: `https://api.edgegap.com`
- URL: `https://api.edgegap.com/v1/locations`
- Auth: API key in header `authorization`

List all the locations available to deploy on. You can specify an application and a version to filter out the locations that don’t have enough resources to deploy this application version.

## Query parameters

- `app` string
- `version` string
- `type` string
- `tags` string

## Response `200`

Success

- Locations
  - `locations` Location[]
    - `city` string, required: City Name
    - `continent` string, required: Continent Name
    - `country` string, required: Country name
    - `timezone` string, required: Timezone name
    - `administrative_division` string, required: Administrative Division
    - `latitude` number, required: The Latitude in decimal
    - `longitude` number, required: The Longitude in decimal
    - `type` string, required: The type of location
    - `tags` Tag[]
      - `key` string, required: Tag's Key
      - `value` string, required: Tag's Value
  - `messages` string[]: Extra Messages for the query

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/edgegap/apis/edgegap-v1.md) · [All operations](https://skmtc.dev/edgegap/apis/edgegap-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/edgegap/apis/edgegap-v1/revisions/9fa2b393a6be?raw)