# API How-Tos

The IONOS Cloud Container Registry service allows you to manage Docker and OCI compatible registries for use by your managed Kubernetes clusters. Use a container registry to make sure you have a private registry to effectively support pulling images.

### Quick Links:

| [<mark style="color:blue;">**GET Locations**</mark>](https://docs.ionos.com/cloud/~/revisions/AMiYziCllTKB2y2lmONY/containers/private-container-registry/api-howtos/locations)                   | [<mark style="color:blue;">**GET Registries**</mark>](https://docs.ionos.com/cloud/~/revisions/AMiYziCllTKB2y2lmONY/containers/private-container-registry/api-howtos/registries)          | [<mark style="color:blue;">**GET Registry by ID**</mark>](https://docs.ionos.com/cloud/~/revisions/AMiYziCllTKB2y2lmONY/containers/private-container-registry/api-howtos/registry_id)  |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [<mark style="color:blue;">**Create Container Registry**</mark>](https://docs.ionos.com/cloud/~/revisions/AMiYziCllTKB2y2lmONY/containers/private-container-registry/api-howtos/create_registry) | [<mark style="color:blue;">**Create Registry Token**</mark>](https://docs.ionos.com/cloud/~/revisions/AMiYziCllTKB2y2lmONY/containers/private-container-registry/api-howtos/create_token) | [<mark style="color:blue;">**Delete Registry**</mark>](https://docs.ionos.com/cloud/~/revisions/AMiYziCllTKB2y2lmONY/containers/private-container-registry/api-howtos/delete_registry) |

### ContainerRegistry API - OpenAPI Specification

{% embed url="<https://api.ionos.com/docs/containerregistry/v1/>" %}
Click here for the OpenAPI Specification File
{% endembed %}

**Endpoint:** `https://api.ionos.com/containerregistries`

To make authenticated requests to the API, you must include a few fields in the request headers. Please find relevant descriptions below:

### Request parameter headers

| Header                | Required |   Type  | Description                                                                                                                       |
| --------------------- | :------: | :-----: | --------------------------------------------------------------------------------------------------------------------------------- |
| **Authorization**     |    yes   |  string | HTTP Basic authorization. A base64 encoded string of a username and password separated by a colon. `username@domain.tld:password` |
| **X-Contract-Number** |    no    | integer | Users with more than one contract may apply this header to indicate the applicable contract.                                      |
| **Content-Type**      |    yes   |  string | Set this to `application/json`.                                                                                                   |

### **Examples**

We use `curl` in our examples, as this tool is available on Windows 10, Linux and macOS. Please refer to our blogpost about `curl` on Windows if you encounter any problems:

{% embed url="<https://www.ionos.com/digitalguide/server/tools/introduction-to-curl-in-linux>" %}

{% embed url="<https://www.ionos.com/digitalguide/server/tools/introduction-to-curl-in-windows>" %}