> ## Documentation Index > Fetch the complete documentation index at: https://docs.aireserve.com/llms.txt > Use this file to discover all available pages before exploring further. # List sandbox offers > Returns short-lived, provider-disclosed capacity facts. Browsing does not reserve capacity or wallet funds. Requires compute `read` access. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/sandbox-offers openapi: 3.0.3 info: title: AI Reserve Gateway API description: >- The AI Reserve API surface — inference, durable environments, workspaces, sandboxes, executions, agent runs, GPU infrastructure, and fine-tuning — all behind one endpoint and one API key. version: 1.0.0 servers: - url: https://api.aireserve.com security: - bearerAuth: [] tags: - name: Customers description: >- Per-end-customer usage, cost, and billable amounts for organizations that tag requests with their own customers. - name: Dedicated GPU endpoints description: >- OpenAI-compatible inference on your organization's own dedicated HuggingFace vLLM deployments, called with an ordinary AI Reserve API key. GPU time is billed from the wallet; requests add no per-token charge. - name: GPU Infrastructure description: >- Provision and manage provider-hidden GPU instances. The recommended Instances API accepts workload requirements and an hourly price ceiling; AI Reserve handles provider placement internally. Every mutation is asynchronous and returns an operation to poll. - name: Environments description: Immutable, versioned runtime definitions. - name: Workspaces description: Durable project storage pinned to one environment version. - name: Sandboxes description: >- Ephemeral provider-disclosed compute allocated from sealed quotes. Requests remain provider-neutral. - name: Executions description: Durable asynchronous operations and command, service, or agent executions. - name: Agent Runs description: Durable Agent SDK runs with replayable events and external artifacts. - name: Customer keys description: >- Mint, list, and revoke API keys pinned to your own end customers (and their organizations), so spend splits per customer without per-request tagging. - name: AWS CLI login description: >- Browser-authorization endpoints consumed by `aws login --profile …` (AWS CLI v2.32.0+). All three routes are unauthenticated — the caller has no credential until `/v1/token` succeeds. - name: Fine-tuning description: >- Fine-tune open models on your own data. Data lives in an S3 bucket inside your organization's AWS hub account; you name a base, LoRA or full, a price ceiling and how the result must be servable, and AI Reserve places the run on a backend internally. The result is a model in your bucket you can deploy or download. - name: 'Admin: Catalog' description: Discover the operations available to this token. - name: 'Admin: Analytics' description: Usage, spend and attribution reads. - name: 'Admin: API Keys' description: Organization and team inference keys. - name: 'Admin: Billing' description: Wallet, ledger and invoice reads. - name: 'Admin: Compute' description: GPU machines and persistent storage (quote, launch, inspect, stop). - name: 'Admin: Compute Runtime' description: >- Portable environments, workspaces, sandboxes, executions, operations and durable agent runs. - name: 'Admin: Containers' description: The organization's AWS account, ECS services, logs and secrets. - name: 'Admin: Files' description: Organization shared files. - name: 'Admin: Members' description: 'People in the organization: invite, profile, team, access, role.' - name: 'Admin: Models & Routing' description: Model availability, defaults, fallbacks and routing. - name: 'Admin: Organization' description: Retention, logging, branding, sign-in domains, classification. - name: 'Admin: Personal' description: The caller's own usage, budget, API keys and preferences. - name: 'Admin: Teams & Budgets' description: Teams, spend caps and allocations. - name: 'Admin: Training' description: Fine-tuning datasets, runs, models and deployments. paths: /v1/sandbox-offers: get: tags: - Sandboxes summary: List sandbox offers description: >- Returns short-lived, provider-disclosed capacity facts. Browsing does not reserve capacity or wallet funds. Requires compute `read` access. operationId: listSandboxOffers parameters: - name: profile in: query required: false description: Only this runtime profile. schema: type: string enum: - standard-vm - elastic-vm - gpu - portable - name: architecture in: query required: false description: Only this CPU architecture. schema: type: string enum: - amd64 - arm64 - name: region in: query required: false description: Only this normalized region. schema: type: string minLength: 1 maxLength: 128 - name: vcpu in: query required: false description: Minimum virtual CPUs. schema: type: integer minimum: 1 maximum: 256 - name: memoryMb in: query required: false description: Minimum memory in MiB. schema: type: integer minimum: 256 maximum: 9007199254740991 - name: gpuAccelerator in: query required: false description: GPU profile accelerator filter. schema: type: string minLength: 1 maxLength: 120 - name: gpuCount in: query required: false description: GPU profile accelerator count. schema: type: integer minimum: 1 maximum: 16 responses: '200': description: OK. headers: {} content: application/json: schema: $ref: '#/components/schemas/SandboxOfferList' '400': description: >- Invalid request, malformed event cursor, missing Idempotency-Key, or schema violation. content: application/json: schema: $ref: '#/components/schemas/ComputeRuntimeError' '401': description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/ComputeRuntimeError' '403': description: The key lacks compute `read` access. content: application/json: schema: $ref: '#/components/schemas/ComputeRuntimeError' '404': description: Resource not found or owned by another organization. content: application/json: schema: $ref: '#/components/schemas/ComputeRuntimeError' '429': description: Rate limit exceeded. headers: Retry-After: description: Whole seconds before the caller should retry. schema: type: integer minimum: 1 content: application/json: schema: $ref: '#/components/schemas/ComputeRuntimeError' '500': description: Unexpected control-plane error (`internal_error`). content: application/json: schema: $ref: '#/components/schemas/ComputeRuntimeError' '503': description: >- No eligible capacity is available or the selected provider is temporarily unavailable. headers: Retry-After: description: Whole seconds before the caller should retry. schema: type: integer minimum: 1 content: application/json: schema: $ref: '#/components/schemas/ComputeRuntimeError' security: - bearerAuth: [] - apiKeyAuth: [] components: schemas: SandboxOfferList: type: object properties: object: type: string enum: - list data: type: array items: type: object properties: id: type: string minLength: 1 maxLength: 255 object: type: string enum: - sandbox_offer profile: type: string enum: - standard-vm - elastic-vm - gpu - portable provider: type: object properties: id: type: string minLength: 1 maxLength: 120 pattern: ^[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?$ description: >- Stable public provider slug. It is a response fact, never a placement input. name: type: string minLength: 1 maxLength: 120 required: - id - name additionalProperties: false description: >- The provider selected by the control plane. Provider account, offer, allocation, region, and operation identifiers are never exposed. resources: type: object properties: vcpu: type: integer minimum: 1 maximum: 256 memoryMb: type: integer minimum: 256 maximum: 2097152 diskGb: type: integer minimum: 1 maximum: 65536 architecture: type: string enum: - amd64 - arm64 region: type: string minLength: 1 maxLength: 128 pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$ gpu: nullable: true type: object properties: accelerator: type: string minLength: 1 maxLength: 120 count: type: integer minimum: 1 maximum: 16 memoryMb: type: integer minimum: 0 exclusiveMinimum: true maximum: 9007199254740991 required: - accelerator - count additionalProperties: false required: - vcpu - memoryMb - diskGb - architecture - region - gpu additionalProperties: false description: >- Resources actually allocated. This never contains provider-native identifiers. supportedActions: maxItems: 8 type: array items: type: string enum: - start - stop - pause - resume - execute - expose_endpoint - revoke_endpoint - terminate availability: type: string enum: - available - limited - unavailable pricing: type: object properties: currency: type: string enum: - USD billingModel: type: string enum: - reserved - observed description: >- `reserved` settles sealed quote-rate time increments; `observed` settles provider-reported actual spend after the reporting lag. rateUsdPerHour: type: string pattern: ^\d{1,10}(?:\.\d{1,6})?$ billingIncrementSeconds: type: integer minimum: 1 maximum: 3600 minimumChargeUsd: type: string pattern: ^\d{1,10}(?:\.\d{1,6})?$ reserveUsd: type: string pattern: ^\d{1,10}(?:\.\d{1,6})?$ description: Amount reserved when the quote is accepted. required: - currency - billingModel - rateUsdPerHour - billingIncrementSeconds - minimumChargeUsd - reserveUsd additionalProperties: false observedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ expiresAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ required: - id - object - profile - provider - resources - supportedActions - availability - pricing - observedAt - expiresAt additionalProperties: false nextCursor: nullable: true type: string minLength: 1 maxLength: 2048 required: - object - data - nextCursor additionalProperties: false ComputeRuntimeError: type: object properties: error: type: object properties: message: type: string minLength: 1 maxLength: 4096 type: type: string enum: - invalid_request_error - authentication_error - permission_error - not_found_error - conflict_error - rate_limit_error - api_error param: nullable: true type: string maxLength: 255 code: type: string enum: - invalid_request - authentication_failed - permission_denied - not_found - idempotency_conflict - invalid_state - unsupported_action - quote_expired - quote_mismatch - quote_consumed - no_capacity - insufficient_funds - operation_conflict - rate_limit_exceeded - provider_unavailable - internal_error details: type: object additionalProperties: {} required: - message - type - param - code additionalProperties: false required: - error additionalProperties: false description: OpenAI-shaped error envelope returned for every JSON error response. securitySchemes: bearerAuth: type: http scheme: bearer description: >- Your AI Reserve API key (aireserve_api_…) from the API Keys page in the portal (https://portal.aireserve.com/keys). apiKeyAuth: type: apiKey in: header name: x-api-key description: The same API key sent as an `x-api-key` header. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.