---
title: "List Cloud Locations"
method: GET
path: "/v1/locations"
tags: ["Deployments", "Integration"]
---

# List Cloud Locations

`GET /v1/locations`

List all locations available for cloud deployment. Optionally specify an app version to remove locations with insufficient capacity to deploy at this time.

## Query parameters

- `app` string
- `version` string
- `page` integer
- `limit` integer

## Headers

- `Accept` string
- `Content-Type` string

## Response `200`

Success

- object
  - `locations` LocationData[] — List of locations available for deployment at this time.
    - `city` string, required — City of the deployment.
    - `country` string, required — Country of the deployment.
    - `continent` string, required — Continent of the deployment.
    - `administrative_division` string, required — Administrative division of the deployment.
    - `timezone` string, required — Timezone of the deployment.
    - `latitude` number, required — Latitude of the deployment
    - `longitude` number, required — Longitude of the deployment.
  - `messages` string[] — Additional information regarding locations.
  - `total_count` integer, required
  - `pagination` object, required
    - `number` integer, required
    - `next_page_number` integer, nullable, required
    - `previous_page_number` integer, nullable, required
    - `paginator` object, required
      - `num_pages` integer, required
    - `has_next` boolean, required
    - `has_previous` boolean, required

## Other responses

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

---

[API](https://skmtc.dev/edgegap/apis/edgegap-v2-api.md) · [All operations](https://skmtc.dev/edgegap/apis/edgegap-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/edgegap/edgegap-v2-api/revisions/8c42320af012/schema)