# Retrieve a specific GPU in a VM

This topic explains how to retrieve the details of a single, specific Graphics Processing Unit (GPU) attached to the Cloud GPU VM.

## Endpoint

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

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

{% tabs %}
{% tab title="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`. |
| {% endtab %}    |          |                             |

{% 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.                                   |
| `datacenterId` | string                                                | The ID of the Data Center where the VM is located. |
| `serverId`     | string                                                | The ID of the server, that is, the Cloud GPU VM.   |
| `gpuId`        | The unique ID of the GPU card attached to the server. |                                                    |
| {% endtab %}   |                                                       |                                                    |

{% tab title="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`. |
| {% endtab %}  |          |                                              |
| {% endtabs %} |          |                                              |

## Response

A successful request returns a **200** status code and a JSON collection containing the complete details of the requested GPU resource.

```json
{
	"id": "f58b1946-c83f-4e70-adcb-2377a232047e",
	"type": "gpu",
	"href": "https://api.ionos.com/cloudapi/v6/datacenters/adc847be-f4f9-4ccc-83f3-5a320d68de39/servers/569738de-a605-40c5-8611-ccc625096a2c/gpus/f58b1946-c83f-4e70-adcb-2377a232047e",
	"metadata": {
		"etag": "45480eb3fbfc31f1d916c1eaa4abdcc3",
    "createdDate": "2015-12-04T14:34:09.809Z",
    "createdBy": "john.doe@example.com",
    "createdByUserId": "7ebaf38d-1234-5c8b-dc1c-c68089f684a0",
		"lastModifiedDate": "2015-12-04T14:34:09.809Z",
    "lastModifiedBy": "john.doe@example.com",
    "lastModifiedByUserId": "7ebaf38d-1234-5c8b-dc1c-c68089f684a0",
   	"state": "AVAILABLE"
	},
	"properties": {
		"name": "GPU NVIDIA Corporation GH100 [H200 NVL] 1",
		"vendor": "NVIDIA Corporation",
		"type": "passthrough",
		"model": "GH100 [H200 NVL]"
	}
}
```