> ## Documentation Index > Fetch the complete documentation index at: https://docs.sfcompute.com/llms.txt > Use this file to discover all available pages before exploring further. # Get instance SKU > > ⚠️ This endpoint is in [public preview](/preview/roadmap). Retrieve an instance SKU by ID, including its properties. ## OpenAPI ````yaml /preview/openapi.json get /preview/v2/instance_skus/{id} openapi: 3.1.0 info: title: sfc-api description: >- Public preview API - subject to change. See https://docs.sfcompute.com/preview/roadmap for details. version: 0.1.0 servers: - url: https://api.sfcompute.com security: - bearer_auth: [] tags: - name: Pools description: A bucket of owned compute balance over time. - name: Orders description: >- Place orders targeting a capacity to increase your reserved compute balance during some time period. - name: Instance Templates description: Reusable instance configuration. - name: Images description: Custom machine images for instances. - name: Roles description: TOML-based permission role definitions. - name: Grants description: Bind principals (users or tokens) to roles on a workspace. - name: Tokens description: Workspace-scoped API tokens. - name: Instances description: Spin up instances in a capacity to use your available compute. - name: Instance SKU Catalog description: Browse available instance SKU property definitions. - name: Procurements description: Market automations that maintain capacity by placing buy/sell orders. - name: Deployments description: Deployment automations that maintain a fleet of instances on a capacity. - name: Users description: Read-only access to users within the caller's organization. - name: Workspaces description: Resource containers scoped to an account. - name: Permissions description: Inspect what the caller is allowed to do. - name: Billing description: Billing profile, contacts, and auto top-up settings. - name: Orderbook description: >- Read-only orderbook visibility: bid/ask spread, depth of book, and historical fills, keyed on hardware requirements + delivery window. - name: Orders description: >- Estimate an order before placing it: filled price, fee, and operational notices. paths: /preview/v2/instance_skus/{id}: get: tags: - Instance SKUs summary: Get instance SKU description: |- > ⚠️ This endpoint is in [public preview](/preview/roadmap). Retrieve an instance SKU by ID, including its properties. operationId: get_instance_sku parameters: - name: id in: path description: Instance SKU ID required: true schema: $ref: '#/components/schemas/InstanceSkuId' responses: '200': description: Instance SKU details. content: application/json: schema: $ref: '#/components/schemas/InstanceSku' '401': description: Unauthorized. content: application/json: schema: $ref: '#/components/schemas/UnauthorizedError' '404': description: Instance SKU not found. content: application/json: schema: $ref: '#/components/schemas/NotFoundError' '500': description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/InternalServerError' security: - bearer_auth: [] components: schemas: InstanceSkuId: oneOf: - type: string examples: - isku_k3R-nX9vLm7Qp2Yw5Jd8F pattern: isku_[0-9a-zA-Z_-]{1,21} - type: string description: Legacy alias prefix; accepted on read, never emitted on write. pattern: clus_[0-9a-zA-Z_-]{1,21} description: >- Accepts the canonical prefix below; additional legacy prefixes are aliased for read compatibility. Writes always emit the canonical form. InstanceSku: type: object description: >- Instance SKU details. See [the instance SKUs guide](https://docs.sfcompute.com/preview/instance-skus). required: - object - id - alias properties: object: type: string const: instance_sku default: instance_sku readOnly: true id: $ref: '#/components/schemas/InstanceSkuId' alias: $ref: '#/components/schemas/Name' description: >- A short, unique, human-recognizable name for this SKU, e.g. `richmond`. For display only - reference the SKU by `id`. region: oneOf: - type: 'null' - type: object required: - value - display_value properties: value: type: string description: >- The geographic region where the hardware is located, e.g. `europe-north1`. display_value: type: string availability_zone: oneOf: - type: 'null' - type: object required: - value - display_value properties: value: type: string description: An independent failure domain within a region, e.g. `a`. display_value: type: string accelerator: oneOf: - type: 'null' - type: object required: - value - display_value properties: value: type: string description: The AI accelerator chip model, e.g. `h100`. display_value: type: string form_factor: oneOf: - type: 'null' - type: object required: - value - display_value properties: value: type: string description: >- The accelerator's physical form factor and host interface, e.g. `sxm`. display_value: type: string rdma_type: oneOf: - type: 'null' - type: object required: - value - display_value properties: value: type: string description: The RDMA technology available on the node. enum: - infiniband - roce display_value: type: string num_accelerators: oneOf: - type: 'null' - type: object required: - value - display_value properties: value: type: integer format: u-int32 description: The number of accelerator chips per node. minimum: 0 display_value: type: string num_vcpus: oneOf: - type: 'null' - type: object required: - value - display_value properties: value: type: integer format: u-int32 description: The number of vCPUs per node, including hyperthreads. minimum: 0 display_value: type: string memory: oneOf: - type: 'null' - type: object required: - value - display_value properties: value: type: integer format: u-int64 description: The total system memory per node, in bytes. minimum: 0 display_value: type: string local_storage: oneOf: - type: 'null' - type: object required: - value - display_value properties: value: type: integer format: u-int64 description: The total local storage available to the VM, in bytes. minimum: 0 display_value: type: string supports_public_ipv4: oneOf: - type: 'null' - type: object required: - value - display_value properties: value: type: boolean description: Whether the node provides a public IPv4 address. display_value: type: string UnauthorizedError: type: object required: - error properties: error: type: object required: - type - message properties: type: type: string const: authentication_error default: authentication_error readOnly: true message: type: string x-speakeasy-error-message: true NotFoundError: type: object required: - error properties: error: type: object required: - type - message properties: type: type: string const: not_found default: not_found readOnly: true message: type: string x-speakeasy-error-message: true InternalServerError: type: object required: - error properties: error: type: object required: - type - message properties: type: type: string const: api_error default: api_error readOnly: true message: type: string x-speakeasy-error-message: true Name: type: string examples: - my-resource-name maxLength: 255 minLength: 1 pattern: '[a-zA-Z0-9][a-zA-Z0-9._-]{0,254}' securitySchemes: bearer_auth: type: http scheme: bearer bearerFormat: JWT description: >- Create an API token using `sf tokens create` or at https://sfcompute.com/account/api-keys. ````