> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nebius.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List

> Lists canonical selectors and their supported purchasing modes.
Omits PricingPolicy mode when Billing discovery is unavailable.



## OpenAPI

````yaml https://api.nebius.cloud/openapi.json get /ai/v1/hardware
openapi: 3.0.3
info:
  title: Nebius API
  version: version not set
servers:
  - url: https://api.nebius.cloud
security:
  - bearerAuth: []
tags:
  - name: nebius.ai.v1.DevlabService
  - name: nebius.ai.v1.EndpointService
  - name: nebius.ai.v1.HardwareService
  - name: nebius.ai.v1.JobService
  - name: nebius.applications.v1alpha1.K8sReleaseService
  - name: nebius.applications.v1alpha1.VmAppTemplateService
  - name: nebius.audit.v2.AuditEventExportService
  - name: nebius.audit.v2.AuditEventService
  - name: nebius.billing.v1.CalculatorService
  - name: nebius.billing.v1.PricingPolicyService
  - name: nebius.billing.v1alpha1.CalculatorService
  - name: nebius.billing.v1alpha1.OneTimeExportService
  - name: nebius.billing.v1alpha1.SpotPriceService
  - name: nebius.capacity.v1.CapacityAllowanceService
  - name: nebius.capacity.v1.CapacityBlockGroupService
  - name: nebius.capacity.v1.CapacityIntervalService
  - name: nebius.capacity.v1.ResourceAdviceService
  - name: nebius.compute.v1.DiskService
  - name: nebius.compute.v1.DiskSnapshotService
  - name: nebius.compute.v1.FilesystemService
  - name: nebius.compute.v1.GpuClusterService
  - name: nebius.compute.v1.ImageService
  - name: nebius.compute.v1.InstanceService
  - name: nebius.compute.v1.MaintenanceService
  - name: nebius.compute.v1.NVLInstanceGroupService
  - name: nebius.compute.v1.NodeService
  - name: nebius.compute.v1.PlatformService
  - name: nebius.dns.v1.RecordService
  - name: nebius.dns.v1.ZoneService
  - name: nebius.iam.v1.AccessKeyService
  - name: nebius.iam.v1.AccessPermitService
  - name: nebius.iam.v1.AuthPublicKeyService
  - name: nebius.iam.v1.FederatedCredentialsService
  - name: nebius.iam.v1.FederationCertificateService
  - name: nebius.iam.v1.FederationService
  - name: nebius.iam.v1.GroupMembershipService
  - name: nebius.iam.v1.GroupService
  - name: nebius.iam.v1.InvitationService
  - name: nebius.iam.v1.ProfileService
  - name: nebius.iam.v1.ProjectService
  - name: nebius.iam.v1.ServiceAccountService
  - name: nebius.iam.v1.SessionManagementService
  - name: nebius.iam.v1.StaticKeyService
  - name: nebius.iam.v1.TenantService
  - name: nebius.iam.v1.TenantUserAccountService
  - name: nebius.iam.v1.TenantUserAccountWithAttributesService
  - name: nebius.iam.v2.AccessKeyService
  - name: nebius.iam.v2.ProjectService
  - name: nebius.iam.v2.TenantService
  - name: nebius.kms.v1.AsymmetricCryptoService
  - name: nebius.kms.v1.AsymmetricKeyService
  - name: nebius.kms.v1.SymmetricCryptoService
  - name: nebius.kms.v1.SymmetricKeyService
  - name: nebius.logging.agentmanager.v1.VersionService
  - name: nebius.logging.v1.LogExportService
  - name: nebius.maintenance.v1alpha1.MaintenanceService
  - name: nebius.mk8s.v1.ClusterService
  - name: nebius.mk8s.v1.NodeGroupService
  - name: nebius.mk8s.v1alpha1.ClusterService
  - name: nebius.mk8s.v1alpha1.NodeGroupService
  - name: nebius.msp.mlflow.v1alpha1.ClusterService
  - name: nebius.msp.postgresql.v1alpha1.BackupService
  - name: nebius.msp.postgresql.v1alpha1.ClusterService
  - name: nebius.mysterybox.v1.PayloadService
  - name: nebius.mysterybox.v1.SecretService
  - name: nebius.mysterybox.v1.SecretVersionService
  - name: nebius.quotas.v1.QuotaAllowanceService
  - name: nebius.registry.v1.ArtifactService
  - name: nebius.registry.v1.RegistryService
  - name: nebius.storage.v1.BucketService
  - name: nebius.storage.v1.InventoryService
  - name: nebius.storage.v1.TransferService
  - name: nebius.storage.v1alpha1.TransferService
  - name: nebius.tunnel.v1.TunnelService
  - name: nebius.vpc.v1.AllocationService
  - name: nebius.vpc.v1.NetworkService
  - name: nebius.vpc.v1.PoolService
  - name: nebius.vpc.v1.RouteService
  - name: nebius.vpc.v1.RouteTableService
  - name: nebius.vpc.v1.SecurityGroupService
  - name: nebius.vpc.v1.SecurityRuleService
  - name: nebius.vpc.v1.SubnetService
  - name: nebius.vpc.v1.TargetGroupService
  - name: nebius.vpc.v1alpha1.AllocationService
  - name: nebius.vpc.v1alpha1.NetworkService
  - name: nebius.vpc.v1alpha1.PoolService
  - name: nebius.vpc.v1alpha1.ScopeService
  - name: nebius.vpc.v1alpha1.SubnetService
paths:
  /ai/v1/hardware:
    get:
      tags:
        - nebius.ai.v1.HardwareService
      summary: List
      description: |-
        Lists canonical selectors and their supported purchasing modes.
        Omits PricingPolicy mode when Billing discovery is unavailable.
      operationId: HardwareService_List
      parameters:
        - description: The customer project used to discover eligible offers.
          in: query
          name: parentId
          required: true
          schema:
            type: string
        - description: >-
            Discovery region. Use the region selected by existing workload
            creation routing.

            This field does not change the routing of subsequent workload
            creation requests.
          in: query
          name: region
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/nebius.ai.v1.ListHardwareResponse'
          description: A successful response.
components:
  schemas:
    nebius.ai.v1.ListHardwareResponse:
      description: Eligible canonical selectors.
      properties:
        items:
          description: Selectors with at least one available purchasing mode.
          items:
            $ref: '#/components/schemas/nebius.ai.v1.Hardware'
          type: array
      type: object
    nebius.ai.v1.Hardware:
      description: One canonical selector and its preferred PAYG resource sizes.
      properties:
        cpuFamily:
          description: Canonical CPU family. Empty for GPU selectors.
          type: string
        gpuCount:
          description: Exact GPU count. Zero for CPU selectors.
          format: int64
          type: integer
        gpuModel:
          description: Canonical GPU model. Empty for CPU selectors.
          type: string
        paygMemoryGib:
          description: >-
            Memory of the preferred PAYG preset, in GiB. Zero when PAYG is
            unavailable.
          format: uint64
          type: string
        paygVcpu:
          description: >-
            Resource sizes of the preferred PAYG preset. Zero when PAYG is
            unavailable.

            Other purchasing modes and existing PricingPolicies can select
            different resource sizes.
          format: int64
          type: integer
        purchasingModes:
          description: Available purchasing modes for this selector.
          items:
            $ref: '#/components/schemas/nebius.ai.v1.Hardware.PurchasingMode'
          type: array
        selector:
          description: Canonical selector, including its GPU or vCPU count.
          type: string
      type: object
    nebius.ai.v1.Hardware.PurchasingMode:
      default: PURCHASING_MODE_UNSPECIFIED
      description: |-
        Purchasing modes supported by an eligible Compute offer.

         - PURCHASING_MODE_UNSPECIFIED: No purchasing mode specified.
         - PAYG: Pay as you go.
         - PVM_MARKET: Preemptible VM at the market price.
         - PVM_PRICING_POLICY: Preemptible VM with an existing PricingPolicy.
      enum:
        - PURCHASING_MODE_UNSPECIFIED
        - PAYG
        - PVM_MARKET
        - PVM_PRICING_POLICY
      type: string
  securitySchemes:
    bearerAuth:
      description: The Authorization header expects a Bearer token.
      scheme: bearer
      type: http

````