---
title: "Get a list of available locations"
method: GET
path: "/available-location/{image}"
---

# Get a list of available locations

`GET /available-location/{image}`

## Request

- Base URL: `https://api.sandbox-gameye.gameye.net`
- URL: `https://api.sandbox-gameye.gameye.net/available-location/{image}`
- Auth: HTTP bearer

Retrieve all locations that are currently able to host your image. This includes an IPV4 address that you may send ICMP ping messages to,  to figure out the latency to this location. Please do not cache this list  anywhere as it may change.

## Response `200`

Ok

- AvailableLocationsOk
  - `locations` AvailableLocationsEntry[], required
    - `id` string, required
    - `ips` string[], required

## Other responses

- `401`: You are not authorized to list available locations. Please make sure that the included bearer token is correct.
- `403`: Your API token may not have the required permissions to invoke this endpoint.
- `404`: Image not found or you are not authorized to use this image.

---

[API](https://skmtc.dev/gameye/apis/gameye-session-api-2.md) · [All operations](https://skmtc.dev/gameye/apis/gameye-session-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/gameye/apis/gameye-session-api-2/revisions/0a019bf29067?raw)