# Retrieve a Template

Templates in IONOS Cloud are pre-configured blueprints that define the specifications and settings for specific server types, Cube, and the GPU. When you retrieve a template, you access its complete configuration details including CPU cores, RAM allocation, storage size, and other properties that can be used to create new instances.

Retrieving template information is useful for:

* **Planning deployments**: Review available configurations before creating instances.
* **Automation**: Programmatically access template specifications for scripted deployments.
* **Resource management**: Understand template capabilities and limitations.
* **Cost estimation**: Analyze resource specifications to estimate usage costs.

This API call returns comprehensive template metadata including creation details, current state, and all configuration properties.

## Endpoint

Use the following endpoint to retrieve a specific template: `https://api.ionos.com/cloudapi/v6/templates/{templateId}`

## Request

{% hint style="info" %}
**Note:** The following request contains sample values. Remember to replace them with the relevant information.
{% endhint %}

```bash
curl --location \
--request GET 'https://api.ionos.com/cloudapi/v6/templates/{templateId}' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJraWQiO' \
--header 'Content-Type: application/json'
```

{% tabs %}
{% tab title="Path Parameters" %}
To make authenticated requests to the API, the following fields are mandatory in the request header:

| **Name**      | **Type** | **Description**                                          |
| ------------- | -------- | -------------------------------------------------------- |
| `v6`          | string   | The API version.                                         |
| `templates`   | string   | Template attributes: `ID`, `metadata`, and `properties`. |
| `templateId`  | string   | The unique template ID.                                  |
| {% endtab %}  |          |                                                          |
| {% endtabs %} |          |                                                          |

## Response

A **200** message confirms that the desired template details are retrieved.

```json
		{
			"id": "e15d15e7-ea9a-48ae-a60a-29b9463f4519",
			"type": "template",
			"href": "https://api.ionos.com/cloudapi/v6/templates/e15d15e7-ea9a-48ae-a60a-29b9463f4519",
			"metadata": {
				"etag": "5e91ac6d46fc3e1da0c0cf6353bc9576",
				"createdDate": "2025-10-16T08:41:00Z",
				"createdBy": "[UNKNOWN]",
				"createdByUserId": "[UNKNOWN]",
				"lastModifiedDate": "2025-12-03T10:54:36Z",
				"lastModifiedBy": "[UNKNOWN]",
				"lastModifiedByUserId": "[UNKNOWN]",
				"state": "AVAILABLE"
			},
			"properties": {
				"name": "H200-S",
				"cores": 15,
				"ram": 273408,
				"storageSize": 1000,
				"storageType": "SSD Premium",
				"category": "GPU Category",
				"gpus": [
					{
						"vendor": "NVIDIA Corporation",
						"model": "GH100 [H200 NVL]",
						"type": "passthrough",
						"count": 1
					}
				]
			}
		}
```