Retrieve Template list
4 min
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' 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 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 	 } 	 ] 	 } 	 }
