> ## 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. # Get ## OpenAPI ````yaml https://api.nebius.cloud/openapi.json get /billing/v1/pricing-policies/{id} 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.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.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: /billing/v1/pricing-policies/{id}: get: tags: - nebius.billing.v1.PricingPolicyService summary: Get operationId: PricingPolicyService_Get parameters: - in: path name: id required: true schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/nebius.billing.v1.PricingPolicy' description: A successful response. components: schemas: nebius.billing.v1.PricingPolicy: description: >- How preemptible VMs are priced: a standing per-GPU bid for one (region, platform). One policy backs any number of VMs, referenced by id from the preemptible spec. A VM without a policy is a price-taker and pays the market price. properties: metadata: allOf: - $ref: '#/components/schemas/nebius.common.v1.ResourceMetadata' description: >- Parent is a project, immutable. Only VMs in that scope may reference the policy. Name is unique within the parent, renamable any time. spec: $ref: '#/components/schemas/nebius.billing.v1.PricingPolicySpec' status: allOf: - $ref: '#/components/schemas/nebius.billing.v1.PricingPolicyStatus' readOnly: true type: object nebius.common.v1.ResourceMetadata: description: Common resource metadata. properties: createdAt: description: Timestamp indicating when the resource was created. format: date-time readOnly: true type: string id: description: Identifier for the resource, unique for its resource type. type: string labels: additionalProperties: type: string description: Labels associated with the resource. type: object name: description: Human readable name for the resource. type: string parentId: description: Identifier of the parent resource to which the resource belongs. type: string resourceVersion: description: >- Version of the resource for safe concurrent modifications and consistent reads. Positive and monotonically increases on each resource spec change (but *not* on each change of the resource's container(s) or status). Service allows zero value or current. format: int64 type: string updatedAt: description: Timestamp indicating when the resource was last updated. format: date-time readOnly: true type: string required: - parentId type: object nebius.billing.v1.PricingPolicySpec: properties: computeInstanceSpec: allOf: - $ref: '#/components/schemas/nebius.billing.v1.ComputeInstanceSpec' description: Preemptible compute instances the policy prices. pricing: allOf: - $ref: '#/components/schemas/nebius.billing.v1.PricingMethod' description: How the price is set. required: - computeInstanceSpec - pricing type: object nebius.billing.v1.PricingPolicyStatus: description: Observed state of a pricing policy. properties: currency: description: ISO 4217 currency code of max_price, e.g. "USD". type: string runningVmCount: description: >- Number of VMs currently running under this policy. Nonzero blocks resource changes and deletion. format: int64 type: string schedulingState: allOf: - $ref: >- #/components/schemas/nebius.billing.v1.PricingPolicyStatus.SchedulingState description: Whether new VMs may currently start under this policy. skuId: description: SKU resolved from the spec. type: string state: $ref: '#/components/schemas/nebius.billing.v1.PricingPolicyStatus.State' type: object nebius.billing.v1.ComputeInstanceSpec: description: Preemptible compute instances a pricing policy applies to. properties: v1: allOf: - $ref: '#/components/schemas/nebius.billing.v1.ComputeInstanceSpecV1' description: First version of the compute instance specification. type: object nebius.billing.v1.PricingMethod: description: How the price of a pricing policy is set. properties: maxPriceV1: allOf: - $ref: '#/components/schemas/nebius.billing.v1.MaxPriceV1' description: |- Auction bid: the per-GPU `max_price` ranks the policy's VMs for scheduling and preemption. type: object nebius.billing.v1.PricingPolicyStatus.SchedulingState: default: SCHEDULING_STATE_UNSPECIFIED description: |2- - SCHEDULING_STATE_ALLOWED: New VMs may start. - SCHEDULING_STATE_BLOCKED: The max_price limit is below the current market price; VM creation succeeds once the price falls to it. enum: - SCHEDULING_STATE_UNSPECIFIED - SCHEDULING_STATE_ALLOWED - SCHEDULING_STATE_BLOCKED type: string nebius.billing.v1.PricingPolicyStatus.State: default: STATE_UNSPECIFIED description: |2- - STATE_CREATING: Not ready yet; a VM referencing the policy gets a retryable error. - STATE_ACTIVE: Ready; whether VMs may start is `scheduling_state`. - STATE_DELETING: Being deleted; does not accept new VMs. - STATE_UPDATING: The bid is being changed; scheduling is blocked until the change lands. enum: - STATE_UNSPECIFIED - STATE_CREATING - STATE_ACTIVE - STATE_DELETING - STATE_UPDATING type: string nebius.billing.v1.ComputeInstanceSpecV1: properties: platform: description: 'Compute platform. Example: "gpu-h100-sxm".' type: string required: - platform type: object nebius.billing.v1.MaxPriceV1: description: Auction-bid pricing. properties: maxPrice: description: >- Per-GPU hourly limit in USD, decimal string 3 digits precision. Example: "3.515". Must be within the allowed price range (OUT_OF_RANGE otherwise); a value below the current market price is accepted but blocks scheduling. Mutable only while `status.running_vm_count` is 0 (FAILED_PRECONDITION otherwise); the policy reports STATE_UPDATING and blocks scheduling while the change is applied. type: string required: - maxPrice type: object securitySchemes: bearerAuth: description: The Authorization header expects a Bearer token. scheme: bearer type: http ````