# GET Locations

To create a container registry, you should be aware of available locations where you can create your container registry.

{% hint style="info" %}
**Note:** The retrieved locations are **read-only** and cannot be changed.
{% endhint %}

## Request

```bash
curl --location \
    --request GET \
    'https://api.ionos.com/containerregistries/locations' \
--header 'Authorization: Bearer ${TOKEN}' \
--data-raw ''
```

## Response

**200 OK - Successfully received the locations of a registry**

```json
{
   "id": "locations",
   "type": "collection",
   "href": "",
   "items": [
       {
           "id": "de/fra"
       }
   ]
}
```

### Response fields

| **Field** |   **Type**   |                  **Description**                  | **Example**                                   |
| --------- | :----------: | :-----------------------------------------------: | --------------------------------------------- |
| **id**    |    string    |   The id of the object that has been retrieved.   | `locations`                                   |
| **type**  |    string    | The type of the resource that has been retrieved. | `collection`                                  |
| **ref**   | URL (string) |  URL to the object representation (absolute path) | `https://api.ionos.com/cloudapi/v6/locations` |
| **items** |     array    |       The location of the container registry      | `"id": "de/fra"`                              |

{% hint style="info" %}
**Note:**

* Your values will differ from those in the sample code. Your response will have different `locations`.
* A location is identified by a combination of the following characters:
* A **two-character** value in `Id` represents a country (example: `de`)
* A **three-character** value in `Id` represents a city. The `locationId` is typically based on the IATA code of the city's airport (example: `fra`).
  {% endhint %}