Retrieve list of GPUs in a VM

This topic explains how to retrieve a list of all Graphics Processing Unit (GPU) cards that are currently attached to a specific server within a Virtual Data Center (VDC). This API request is useful for auditing the resources of a server or verifying a successful GPU attachment.

Endpoint

Use the following endpoint for templates: https://api.ionos.com/cloudapi/v6/datacenters/{datacenterId}/servers/{serverId}/gpus

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/datacenters/{datacenterId}/servers/{serverId}/gpus' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJraWQiO' \
--header 'Content-Type: application/json'

Header Parameters

To make authenticated requests to the API, the following fields are mandatory in the request header:

Name	Type	Description
Authorization	string	The bearer token.
Content-Type	string	Must be application/json.

Path Parameters

Query Parameters

Response

A successful request returns a 200 status code and a JSON collection containing a list of GPU resources attached to the specified server.

"gpus": {
            "id": "f721a-9b40-4ece-a63b-5f81135/gpus",
            "type": "collection",
            "href": "<RESOURCE-URI>",
            "items": [
                {
                    "id": "e7972-d406-46ce-9401-ad51b81",
                    "type": "gpu",
                    "href": "<RESOURCE-URI>",
                    "metadata": {
                        "etag": "8869d306a",
                        "createdDate": "2025-11-10T10:43:58Z",
                        "createdBy": "[email protected]",
                        "createdByUserId": "a3ae84-b7a3-4386-84f2-2d3c2bc2e",
                        "lastModifiedDate": "2025-11-10T10:43:58Z",
                        "lastModifiedBy": "[email protected]",
                        "lastModifiedByUserId": "a3ae84-b7a3-4386-84f2-2d3c2bc2e",
                        "state": "AVAILABLE"
                    },
                    "properties": {
                        "name": "GPU NVIDIA Corporation GA100 [A100 PCIe 80GB] 1",
                        "vendor": "NVIDIA Corporation",
                        "type": "passthrough",
                        "model": "GA100 [A100 PCIe 80GB]"
                    }
                }
            ]
        }