# API reference — Robots

Embodiment discovery. Robots are addressed as `model@firmware`.

## GET /v1/robots

List robots

Embodiments available in the facility, with pinned firmwares, cell counts, live duty cycle, and rate-card tier (`soak` commodity pods or `verify` verification-tier hardware).

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| class | query | `humanoid \| quadruped-manip \| bimanual \| mobile-manipulator \| fixed-arm \| arm-pod` | no |  |
| tier | query | `soak \| verify` | no |  |

Example response (200):

```json
{
 "object": "list",
 "url": "/v1/robots",
 "data": [
  {
   "id": "g1-edu-pro",
   "class": "humanoid",
   "dof": 37,
   "hands": "dex3-1",
   "firmwares": [
    "2.3",
    "2.4"
   ],
   "cells": 6,
   "duty_cycle_pct": 71,
   "tier": "verify"
  },
  {
   "id": "nori-a3",
   "class": "arm-pod",
   "dof": 6,
   "hands": "gripper-2f",
   "firmwares": [
    "1.0"
   ],
   "cells": 24,
   "duty_cycle_pct": 83,
   "tier": "soak"
  }
 ]
}
```