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

Note: The following request contains sample values. Remember to replace them with the relevant information.

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

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.

Response

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

		{
			"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
					}
				]
			}
		}