> ## Documentation Index > Fetch the complete documentation index at: https://otoyinc.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List Compute Offers ## OpenAPI ````yaml https://api.dispersed.com/openapi.json get /v1/compute/offers openapi: 3.1.0 info: title: Dispersed API version: 1.0.0 servers: - url: https://api.dispersed.com security: [] paths: /v1/compute/offers: get: tags: - Compute summary: List Compute Offers parameters: - schema: type: integer minimum: 1 maximum: 50 example: 1 required: false name: limit in: query - schema: type: integer minimum: 1 maximum: 9007199254740991 example: 1 required: false name: page in: query - schema: type: string example: created_at OR -created_at required: false name: sort in: query - schema: type: - integer - 'null' minimum: 0 example: '8' required: false name: filter[cpu_count] in: query - schema: type: - integer - 'null' minimum: 0 example: '1' required: false name: filter[gpu_count] in: query - schema: type: string example: RTX 4090 required: false name: filter[gpu_name] in: query - schema: type: string format: uuid example: 019582a6-27fc-731d-af0a-594f04d6d0d5 required: false name: filter[gpu_registry_uuid] in: query - schema: type: - integer - 'null' minimum: 0 example: '24' required: false name: filter[min_vram_gb] in: query - schema: type: - integer - 'null' minimum: 0 example: '64' required: false name: filter[min_ram_gb] in: query - schema: type: - integer - 'null' minimum: 0 example: '100' required: false name: filter[min_storage_gb] in: query - schema: type: string description: >- Restricts offers to nodes whose response `region_code` is in this comma-separated allowlist. This is intersected with the requester`s workspace and consumer-profile policies. example: us-west-1,us-west-2 required: false description: >- Restricts offers to nodes whose response `region_code` is in this comma-separated allowlist. This is intersected with the requester`s workspace and consumer-profile policies. name: filter[allowed_region_codes] in: query - schema: type: string enum: - 'true' - 'false' description: >- ADMIN-only. When `true`, bypasses workspace, consumer-profile, and public allowed_region_codes constraints so the raw offer surface is visible (diagnostics). example: 'false' required: false description: >- ADMIN-only. When `true`, bypasses workspace, consumer-profile, and public allowed_region_codes constraints so the raw offer surface is visible (diagnostics). name: filter[ignore_region_constraints] in: query responses: '200': description: List of compute offers content: application/json: schema: $ref: '#/components/schemas/ListComputeOffersResponse' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: ListComputeOffersResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/ComputeOfferResponse' limit: type: integer page: type: integer total: type: integer required: - data - limit - page - total ErrorResponse: type: object properties: error: $ref: '#/components/schemas/Error' required: - error ComputeOfferResponse: type: object properties: availability: type: object properties: status: type: string enum: - AVAILABLE - LIMITED required: - status hardware_summary: type: object properties: cpu_cores: type: integer gpu_count: type: integer gpu_model_label: type: - string - 'null' gpu_models: type: array items: type: object properties: count: type: integer exclusiveMinimum: 0 gpu_registry_uuid: type: - string - 'null' min_vram_gib: type: - integer - 'null' name: type: string required: - count - gpu_registry_uuid - min_vram_gib - name gpu_registry_uuid: type: - string - 'null' min_gpu_vram_gib: type: - integer - 'null' ram_gib: type: integer storage_gib: type: integer required: - cpu_cores - gpu_count - gpu_model_label - gpu_models - gpu_registry_uuid - min_gpu_vram_gib - ram_gib - storage_gib offer_id: type: string pricing: type: object properties: hourly_rate_usd: type: number quoted_at: type: - string - 'null' format: date-time required: - hourly_rate_usd - quoted_at region_code: $ref: '#/components/schemas/RegionCode' required: - availability - hardware_summary - offer_id - pricing Error: type: object properties: code: type: string details: type: array items: type: object properties: code: type: string expected: type: string input: type: string keys: type: array items: type: string message: type: string path: type: array items: anyOf: - type: string - type: number required: - message - path default: [] message: type: string status: type: number timestamp: type: string required: - code - message - status - timestamp RegionCode: type: - string - 'null' enum: - ca-central-1 - ca-west-1 - mx-central-1 - sa-east-1 - us-east-1 - us-east-2 - us-west-1 - us-west-2 - eu-central-1 - eu-central-2 - eu-north-1 - eu-south-1 - eu-south-2 - eu-west-1 - eu-west-2 - eu-west-3 - ap-east-1 - ap-east-2 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-south-1 - ap-south-2 - ap-southeast-1 - ap-southeast-2 - ap-southeast-3 - ap-southeast-4 - ap-southeast-5 - ap-southeast-6 - ap-southeast-7 - cn-north-1 - cn-northwest-1 - af-south-1 - il-central-1 - me-central-1 - me-south-1 - null default: null description: Coarse geographic-network region identifier (AWS-style naming). example: us-west-2 ````