---
title: "List Bases"
method: GET
path: "/jobs/bases"
tags: ["jobs"]
---

# List Bases

`GET /jobs/bases`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/jobs/bases`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Every robot base, then every lora_trl base model (an LLM LoRA), then every halo_rft one
(hosted RFT, the default for tasks with a verifier), then every halo_rlvr one (online RLVR on
Halo, its upgrade).

## Response `200`

Successful Response

- CatalogBase[]
  - `base` string, required
  - `base_model` string, nullable, required
  - `family` 'robot' | 'llm' | 'rft' | 'rlvr', required
  - `name` string, required
  - `repo` string, required
  - `revision` string, required
  - `license` string, required
  - `params` integer, nullable
  - `available` boolean, required
  - `trainable` boolean, required
  - `tier_refusal` TierRefusal: The 403 detail POST /jobs answers for a job your organisation's LLM plan does not include.
    - `code` 'llm_tier_required' | 'llm_tier_expired' | 'llm_tier_no_gpu' | 'llm_tier_training', required
    - `tier` string, nullable, required
    - `message` string, required
  - `gpu_count` integer, required
  - `batch` integer, required
  - `trainers` string[]
  - `unfit` string, nullable
  - `recipes` string[]
  - `servable` boolean, required
  - `action_space_id` string, nullable, required
  - `action_dim` integer, nullable, required
  - `inputs` BaseInputs: What a robot base's model takes as input beyond its cameras' colour images and the state. `depth`: depth maps, a version's depth streams (its observation.depths.* features); a job trains with them only when it asks to (use_depth), and only on a base that takes them.
    - `depth` boolean, required
  - `gated` CatalogGate[]
    - `repo` string, required
    - `terms` string, required
    - `terms_name` string, required
    - `terms_url` string, required
    - `platform_access` boolean, required
    - `accepted` boolean, required
  - `qualification` Qualification
    - `licence` Licence, required: The terms that govern the base's weights, the files its checkpoints load and its code.
      - `terms` string, required
    - `known_limits` string[], required
    - `training_smoke` Smoke, required
      - `job_id` string, required
      - `image_digest` string, required
      - `current` boolean, required
      - `checkpoint_sha256` string, required
      - `receipt_sha256` string, required
      - `steps` integer, nullable, required
      - `resumed_from_step` string, nullable, required
      - `finished_at` string, nullable, required
    - `serving` Serving, required
      - `endpoint_id` string, uuid, required
      - `image_digest` string, required
      - `current` boolean, required
      - `gpu` string, required
      - `handshake` HandshakeRecord, required: What a policy server declares when a controller connects; every field is required.
        - `checkpoint_sha256` string, required
        - `action_space_id` string, required
        - `action_dim` integer, required
        - `wire_contract_version` string, required
        - `camera_shapes` object, required
        - `controller_api_version` string, required
        - `endpoint_type` 'vla_policy' | 'planner_llm' | 'harness' | 'llm_vllm' | 'llm_sglang', required
        - `observation` ObservationSchema
          - `schema_version` 'os3.observation_schema.v1', required
          - `modalities` object, required
        - `action_adapter` ActionAdapter
          - `schema_version` 'os3.action_adapter.v1', required
          - `action_space_id` string, required
          - `names` string[], required
          - `units` string[], required
          - `relative_channels` integer[]
          - `relative_to` string, nullable
        - `model_ref` string, required
        - `min_controller` string, nullable
      - `warm_ms` number, required
      - `chunks` integer, required
      - `p50_ms` number, required
      - `p95_ms` number, required
      - `measured_at` string, date-time, required
    - `tasks` TaskResult[], required
      - `task` string, required
      - `eval_run_id` string, required
      - `candidate_ref` string, required
      - `robot_ref` string, nullable, required
      - `n` integer, required
      - `successes` integer, required
      - `hard_failures` integer, required
      - `ci_lower` number, required
      - `ci_upper` number, required
      - `finished_at` string, required
  - `deployable` boolean

---

[API](https://skmtc.dev/os3robotics/apis/os3-api.md) - [All operations](https://skmtc.dev/os3robotics/apis/os3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/os3robotics/apis/os3-api/revisions/af32cd4f14bb?raw)