# API reference — Environments

Versioned catalogue scenes, from bare `cell-a` to `surgical-replica@v3`.

## GET /v1/environments

List environments

Versioned catalogue scenes. `adder_tier` (`bare | standard | replica | instrumented-replica`) maps to the environment-hour rate card.

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| cls | query | `string` | no | Filter by scene class, e.g. `kitchen`. |

Example response (200):

```json
{
 "object": "list",
 "url": "/v1/environments",
 "data": [
  {
   "id": "kitchen-std",
   "rev": "v1.2",
   "class": "kitchen",
   "instrumentation": [
    "mocap",
    "ft"
   ],
   "objects": 214,
   "reset": "scripted",
   "adder_tier": "replica"
  }
 ]
}
```