Retrieve Template list

You can retrieve a list of configuration templates that are currently available. Instances have a fixed configuration of vCPU, RAM, and direct-attached storage size.

Endpoint

Use the following endpoint for templates: https://api.ionos.com/cloudapi/v6/templates/?depth=3 The depth parameter will expand the response payload so you can process the payload across all templates and identify the needed templates for your use case.

Note: The list contains templates for Cubes as well as GPU instances. We recommend checking the naming convention to confirm the instance type the template is intended for.

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/?depth=3' \
--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.

Query Parameters

You can refine your request by adding the optional query parameter depth.

Name	Type	Description
depth	integer	Template detail depth. Default value is 0.

Response

A 200 message confirms that the templates list is fetched. The response will contain multiple templates,each in the format shown in the response example.

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