> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runpod.io/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.1.0
info:
  title: Runpod REST API
  version: 2.0.0
  description: Runpod public REST API — v2
servers:
  - url: https://api.runpod.io
    description: Runpod API v2 production server
security:
  - bearerAuth: []
tags:
  - name: Pods
    description: GPU and CPU pod lifecycle, configuration, actions, and log streaming.
  - name: Serverless
    description: >-
      Serverless endpoint lifecycle, worker visibility, releases, and worker log
      streaming.
  - name: Templates
    description: Reusable pod and endpoint configuration templates.
  - name: Network Volumes
    description: Persistent network storage volumes for workloads.
  - name: Registries
    description: Container registry credentials used to pull private images.
  - name: Catalog
    description: Available GPU, CPU, and data center catalog metadata.
  - name: Billing
    description: Billing history and usage cost records across resource types.
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'
              examples:
                cpus:
                  summary: Successful response
                  value:
                    cpus:
                      - id: cpu3c-2-4
                        name: Compute-Optimized
                        group: Gen 3
                        vcpu:
                          min: 2
                          max: 32
                        ramGbPerVcpu: 2.5
                        price:
                          securePerVcpu: 0.04
                          serverlessPerVcpu: 0.03
                        availability: MEDIUM
                        dataCenters:
                          - id: US-KS-2
                            name: US Kansas 2
                            availability: MEDIUM
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          $ref: '#/components/responses/ForbiddenError'
        '429':
          $ref: '#/components/responses/TooManyRequestsError'
        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
      required:
        - title
        - status
        - detail
      properties:
        title:
          type: string
          description: Short human-readable summary
          examples:
            - Not Found
        status:
          type: integer
          description: HTTP status code
          examples:
            - 404
        detail:
          type: string
          description: Human-readable explanation
          examples:
            - pod not found
        errors:
          type: array
          description: Individual request-validation failures.
          items:
            type: string
          examples:
            - - '$: additional properties ''bogus'' not allowed'
    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)
          examples:
            - cpu5c
        name:
          type: string
          description: Human-readable flavor name
          examples:
            - Compute-Optimized
        group:
          type: string
          description: CPU generation group
          examples:
            - Gen 5
        vcpu:
          type: object
          required:
            - min
            - max
          properties:
            min:
              type: integer
              examples:
                - 2
            max:
              type: integer
              examples:
                - 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.
          examples:
            - 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.
              examples:
                - 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.
              examples:
                - 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.
          examples:
            - US-CA-2
        name:
          type: string
          description: Human-readable data center name.
          examples:
            - US California 2
        availability:
          $ref: '#/components/schemas/AvailabilityLevel'
  responses:
    UnauthorizedError:
      description: >-
        Authentication failed because the bearer token is missing, malformed,
        expired, or invalid.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            missingBearerToken:
              summary: Missing bearer token
              value:
                title: Unauthorized
                status: 401
                detail: missing bearer token
    ForbiddenError:
      description: >-
        The bearer token is valid, but it does not grant access to the requested
        resource or action.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            insufficientAccess:
              summary: Insufficient access
              value:
                title: Forbidden
                status: 403
                detail: access denied
    TooManyRequestsError:
      description: >
        The caller exceeded its per-user rate limit. The response identifies the
        window that was exceeded and how long to wait. The `RateLimit` and
        `RateLimit-Policy` headers (per the IETF ratelimit-headers draft) also
        accompany successful responses, so clients can track quota before a 429.
      headers:
        Retry-After:
          description: Seconds to wait before retrying, per the exceeded window.
          schema:
            type: integer
          example: 12
        RateLimit:
          description: >
            Live per-window state as a structured-field list — one member per
            window (`minute`, `hour`, `day`) with remaining count `r` and
            seconds-until-reset `t`.
          schema:
            type: string
          example: '"minute";r=0;t=12, "hour";r=2800;t=1812, "day";r=49500;t=45012'
        RateLimit-Policy:
          description: >
            Static quota policy as a structured-field list — one member per
            window with quota `q` and window length `w` (seconds).
          schema:
            type: string
          example: '"minute";q=60;w=60, "hour";q=3000;w=3600, "day";q=50000;w=86400'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            rateLimited:
              summary: Rate limit exceeded
              value:
                title: Too Many Requests
                status: 429
                detail: rate limit exceeded for the minute window
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Runpod API Key
      description: >
        Runpod API key authentication. Generate an API key in the Runpod console
        and send it in the `Authorization` header as `Bearer <api_key>`. Keys
        are scoped to the permissions granted when created; requests may return
        `403` when a valid key lacks access to the requested resource or action.

````