List GPU VMs

​

Get a paginated list of GPU VMs for the current entity. Requires GPU feature to be enabled.

Query Parameters
  • page
    Type: integer
    min:  
    1

    Page number (1-indexed, default: 1)

  • limit
    Type: integer
    min:  
    1
    max:  
    100

    Items per page (max: 100; default varies by endpoint)

  • sort
    Type: string

    Sort field and direction (e.g., "createdAt:desc", "name:asc"). Supports comma-separated values for multi-column sorting.

  • search
    Type: string

    Search term (searches in GPU VM name)

  • resourceGroupId
    Type: stringFormat: uuid

    Filter by resource group ID

Responses
  • application/json
  • application/json
  • 403

    GPU feature not enabled for this entity

  • application/json
Request Example for get/resource/gpu
curl 'https://api.gpcn.com/v1/resource/gpu?page=1&limit=1&sort=createdAt%3Adesc&search=&resourceGroupId=' \
  --header 'X-API-Key: YOUR_SECRET_TOKEN'

{
  "success": true,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "string",
      "createdAt": "2026-05-19T14:02:02.487Z",
      "updatedAt": "2026-05-19T14:02:02.487Z",
      "deletedAt": "2026-05-19T14:02:02.487Z",
      "status": "Provisioning",
      "configuration": {
        "name": "string",
        "code": "string",
        "gpuCount": 1,
        "cpu": 1,
        "ram": 1,
        "disk": 1,
        "skuId": "123e4567-e89b-12d3-a456-426614174000",
        "skuCode": "string"
      },
      "ip": "string",
      "datacenter": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "string",
        "region": "string",
        "countryAbbr": "string",
        "country": "string"
      },
      "resourceGroupId": "123e4567-e89b-12d3-a456-426614174000",
      "resourceGroupName": "string"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "pageSize": 1,
    "totalPages": 1,
    "hasNextPage": true,
    "hasPreviousPage": true
  }
}

Successfully retrieved GPU VMs