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

# List Products



## OpenAPI

````yaml api-reference/gpus-v2-spec/list-products.json GET /gpus/v2/products
openapi: 3.0.0
info:
  title: Novita GPU API v2
  version: 2.0.0
servers:
  - url: https://api.novita.ai
security: []
paths:
  /gpus/v2/products:
    get:
      summary: List Products
      parameters:
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
          description: 'Bearer authentication format, e.g.: `Bearer {{API_KEY}}`.'
        - name: type
          in: query
          required: true
          schema:
            type: string
            enum:
              - gpu
              - cpu
          description: >-
            Product type. Defaults to `gpu` when empty. Allowed values: `gpu`,
            `cpu`.
          example: gpu
        - name: category
          in: query
          required: true
          schema:
            type: string
            enum:
              - serverless
              - instance
          description: 'Product category. Allowed values: `serverless`, `instance`.'
          example: instance
        - name: cpu
          in: query
          required: false
          schema:
            type: integer
          description: CPU core tier. Integer, value >= 0.
        - name: memory_gb
          in: query
          required: false
          schema:
            type: integer
          description: 'Memory tier. Integer, value >= 0. Unit: GB.'
        - name: rootfs_size
          in: query
          required: false
          schema:
            type: integer
          description: 'Root disk size. Integer, value >= 0. Unit: GB.'
        - name: billing_method
          in: query
          required: false
          schema:
            type: string
            enum:
              - postpaid
              - prepaid
              - spot
          description: 'Billing method. Allowed values: `postpaid`, `prepaid`, `spot`.'
        - name: region_ids
          in: query
          required: false
          schema:
            type: string
          description: Region filter. Multiple Region IDs are comma-separated.
          example: c-east-1
        - name: limit
          in: query
          required: false
          schema:
            type: integer
          description: Maximum number of items to return. Integer, value >= 0.
        - name: cursor
          in: query
          required: false
          schema:
            type: string
          description: >-
            Cursor returned by the previous page. Leave empty for the first
            request. String, length: 0-1024 characters.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: Product list
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Product ID
                          example: prod-a100-80g
                        name:
                          type: string
                          description: Product name
                          example: A100-80G
                        type:
                          type: string
                          enum:
                            - gpu
                            - cpu
                          description: 'Product type. Allowed values: `gpu`, `cpu`'
                          example: gpu
                        category:
                          type: string
                          enum:
                            - serverless
                            - instance
                          description: >-
                            Product category. Allowed values: `serverless`,
                            `instance`
                          example: instance
                        description:
                          type: string
                          description: Product description
                          example: NVIDIA A100 80GB
                        region_ids:
                          type: array
                          items:
                            type: string
                          description: Regions where the product is available
                          example:
                            - c-east-1
                        resource_spec:
                          type: object
                          description: >-
                            Resource specification (GPU / CPU / memory / root
                            disk)
                          properties:
                            gpu:
                              type: object
                              nullable: true
                              description: GPU resource. `null` or omitted for CPU products
                              properties:
                                spec_id:
                                  type: string
                                  description: GPU spec ID
                                  example: spec-a100-80g
                                name:
                                  type: string
                                  description: GPU model name
                                  example: A100
                                memory_gb:
                                  type: integer
                                  description: 'VRAM per card. Unit: GB'
                                  example: 80
                                min:
                                  type: integer
                                  description: Minimum number of GPUs that can be selected
                                  example: 1
                                max:
                                  type: integer
                                  description: Maximum number of GPUs that can be selected
                                  example: 8
                                available:
                                  type: integer
                                  description: >-
                                    GPUs available on the current best node
                                    (real-time)
                                  example: 6
                                max_available:
                                  type: integer
                                  description: >-
                                    Maximum allocatable GPUs on a single
                                    candidate node (real-time)
                                  example: 6
                            cpu:
                              type: integer
                              description: CPU cores
                              example: 16
                            memory_gb:
                              type: integer
                              description: 'Memory size. Unit: GB'
                              example: 128
                            rootfs:
                              type: object
                              description: Root disk specification
                              properties:
                                min_gb:
                                  type: integer
                                  description: 'Minimum root disk size. Unit: GB'
                                  example: 50
                                max_gb:
                                  type: integer
                                  description: 'Maximum root disk size. Unit: GB'
                                  example: 500
                                free_gb:
                                  type: integer
                                  description: >-
                                    Free quota included in the base price. Unit:
                                    GB
                                  example: 50
                        pricing:
                          type: object
                          description: >-
                            Pricing information (instance price + storage price
                            share one structure)
                          properties:
                            precision:
                              type: integer
                              description: >-
                                Price precision — number of decimal places for
                                price fields
                              example: 3
                            postpaid:
                              type: object
                              nullable: true
                              description: >-
                                Pay-as-you-go price. `null` when not supported.
                                Serverless products use this structure to
                                express the spec price
                              properties:
                                base_price:
                                  type: integer
                                  description: Original price
                                  example: 18000
                                final_price:
                                  type: integer
                                  description: >-
                                    Actual price paid. Maps to the original
                                    `discount` field for Serverless
                                  example: 12600
                                unit:
                                  type: string
                                  description: Pricing unit, e.g. `per_hour`
                                  example: per_hour
                            spot:
                              type: object
                              nullable: true
                              description: Spot price. `null` when not supported
                              properties:
                                base_price:
                                  type: integer
                                  description: Original price
                                  example: 12600
                                final_price:
                                  type: integer
                                  description: Actual price paid
                                  example: 6000
                                unit:
                                  type: string
                                  description: Pricing unit, e.g. `per_hour`
                                  example: per_hour
                            prepaid:
                              type: array
                              description: Monthly subscription price tiers
                              items:
                                type: object
                                properties:
                                  spec_id:
                                    type: string
                                    description: Billing spec ID
                                    example: spec_a100_1m
                                  duration_months:
                                    type: integer
                                    description: Subscription length in months
                                    example: 1
                                  final_price:
                                    type: integer
                                    description: Actual price paid for this tier
                                    example: 9072000
                                  base_price:
                                    type: integer
                                    description: Original price for this tier
                                    example: 12960000
                            storage_price_per_gb:
                              type: integer
                              description: Storage price per GB. Used by instance products
                              example: 50
                        billing_methods:
                          type: array
                          items:
                            type: string
                            enum:
                              - postpaid
                              - prepaid
                              - spot
                          description: >-
                            Supported billing methods. Allowed values:
                            `postpaid`, `prepaid`, `spot`
                          example:
                            - postpaid
                            - prepaid
                            - spot
                        inventory_state:
                          type: string
                          enum:
                            - none
                            - low
                            - normal
                            - high
                          description: >-
                            Inventory state. Allowed values: `none` (out of
                            stock), `low` (limited stock), `normal` (in stock),
                            `high` (high stock)
                          example: normal
                        deployable:
                          type: boolean
                          description: >-
                            Whether the product is deployable. `true` when there
                            is a best-fit node that can host this order
                          example: true
                        activity:
                          type: object
                          description: Promotional activity information
                          properties:
                            is_activity_product:
                              type: boolean
                              description: Whether this is an activity product
                              example: false
                            active:
                              type: boolean
                              description: >-
                                Whether the activity is currently within its
                                effective time window
                              example: false
                            purchasable:
                              type: boolean
                              description: Whether the product is purchasable
                              example: true

````