> ## Documentation Index
> Fetch the complete documentation index at: https://runpod-b18f5ded-lg-apiv2-new.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List CPU types

> Returns available CPU flavors. Availability is included only when requested with include=AVAILABILITY.



## OpenAPI

````yaml get /v2/catalog/cpus
openapi: 3.0.3
info:
  title: RunPod REST API
  version: 2.0.0
  description: RunPod public REST API — v2
servers:
  - url: /
    description: Current server
security:
  - bearerAuth: []
paths:
  /v2/catalog/cpus:
    get:
      tags:
        - Catalog
      summary: List CPU types
      description: >-
        Returns available CPU flavors. Availability is included only when
        requested with include=AVAILABILITY.
      operationId: listCpuTypes
      parameters:
        - $ref: '#/components/parameters/CatalogIncludeParam'
        - $ref: '#/components/parameters/CpuProductFilter'
        - $ref: '#/components/parameters/CpuVCPUCountFilter'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListCpuTypesResponse'
        default:
          description: Error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  parameters:
    CatalogIncludeParam:
      name: include
      in: query
      required: false
      description: >-
        Comma-separated optional expansions. Supported value today:
        AVAILABILITY. This may expand with more include values in the future.
      style: form
      explode: false
      schema:
        type: array
        maxItems: 1
        items:
          $ref: '#/components/schemas/CatalogInclude'
      example:
        - AVAILABILITY
    CpuProductFilter:
      name: product
      in: query
      required: false
      description: >-
        Comma-separated availability product context. Valid only with
        include=AVAILABILITY. Supported values for CPUs: POD, SERVERLESS.
        Defaults to POD when omitted.
      schema:
        type: array
        items:
          $ref: '#/components/schemas/CpuProduct'
        example:
          - POD
          - SERVERLESS
    CpuVCPUCountFilter:
      name: vcpuCount
      in: query
      required: false
      description: >-
        Availability vCPU count. Valid only with include=AVAILABILITY. Must be a
        power of two.
      schema:
        type: integer
        minimum: 2
      example: 4
  schemas:
    ListCpuTypesResponse:
      type: object
      required:
        - cpus
      properties:
        cpus:
          type: array
          items:
            $ref: '#/components/schemas/CpuType'
    ErrorResponse:
      type: object
      properties:
        title:
          type: string
          description: Short human-readable summary
          example: Not Found
        status:
          type: integer
          description: HTTP status code
          example: 404
        detail:
          type: string
          description: Human-readable explanation
          example: pod not found
    CatalogInclude:
      type: string
      description: >-
        Catalog include expansion. Only AVAILABILITY is supported today;
        additional include values may be added in the future.
      enum:
        - AVAILABILITY
    CpuProduct:
      type: string
      description: CPU catalog product availability context.
      enum:
        - POD
        - SERVERLESS
    CpuType:
      type: object
      required:
        - id
        - name
        - group
        - vcpu
        - ramGbPerVcpu
        - price
      properties:
        id:
          type: string
          description: CPU flavor identifier (use in cpu.id for pod creation)
          example: cpu5c
        name:
          type: string
          description: Human-readable flavor name
          example: Compute-Optimized
        group:
          type: string
          description: CPU generation group
          example: Gen 5
        vcpu:
          type: object
          required:
            - min
            - max
          properties:
            min:
              type: integer
              example: 2
            max:
              type: integer
              example: 32
        ramGbPerVcpu:
          type: number
          format: float
          description: |
            GB of RAM allocated per vCPU. Multiply by the chosen vCPU
            count (within `vcpu.min`..`vcpu.max`) to get the total RAM
            for an instance of this flavor. May be fractional.
          example: 2.5
        price:
          type: object
          required:
            - securePerVcpu
            - serverlessPerVcpu
          properties:
            securePerVcpu:
              type: number
              format: float
              description: |
                Price for secure pods per vCPU. Multiply by the chosen vCPU
                count (within `vcpu.min`..`vcpu.max`) to get the total price.
              example: 0.04
            serverlessPerVcpu:
              type: number
              format: float
              description: |
                Price for serverless per vCPU. Multiply by the chosen vCPU
                count (within `vcpu.min`..`vcpu.max`) to get the total price.
              example: 0.03
        availability:
          $ref: '#/components/schemas/AvailabilityLevel'
          description: >-
            Overall CPU availability. Present only when requested with
            include=AVAILABILITY.
        dataCenters:
          type: array
          description: >-
            Per-datacenter CPU availability. Present only when requested with
            include=AVAILABILITY.
          items:
            $ref: '#/components/schemas/DataCenterAvailability'
    AvailabilityLevel:
      type: string
      description: Catalog stock availability level.
      enum:
        - NONE
        - LOW
        - MEDIUM
        - HIGH
    DataCenterAvailability:
      type: object
      required:
        - id
        - name
        - availability
      properties:
        id:
          type: string
          description: Data center identifier.
          example: US-CA-2
        name:
          type: string
          description: Human-readable data center name.
          example: US California 2
        availability:
          $ref: '#/components/schemas/AvailabilityLevel'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: RunPod API Key

````