# API reference — Quote

Price a job before you run it. Both meters are visible in every quote.

## POST /v1/quote

Quote a job

Prices a job before you run it. Both meters — robot-hours and environment-hours — are visible in every quote, with a queue ETA for the requested priority.

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| robot | body | `string` | yes |  |
| environment | body | `string` | yes |  |
| episodes | body | `EpisodesSpec` | yes | An integer episode count, or `auto(ci=…, moe=…)` which sizes n for a target margin of error at the given confidence (Wilson interval). |
| priority | body | `burst \| standard \| soak` | no |  |

Example request:

```json
{
 "robot": "g1-edu-pro",
 "environment": "kitchen-std",
 "episodes": 600
}
```

Example response (200):

```json
{
 "object": "quote",
 "robot": "g1-edu-pro",
 "environment": "kitchen-std",
 "episodes": 600,
 "priority": "standard",
 "robot_hours": 20,
 "env_hours": 20,
 "usd": 3740,
 "queue_eta": "6h",
 "breakdown": {
  "minutes_per_episode_est": 2,
  "robot_usd_per_hour": 148,
  "env_usd_per_hour": 39,
  "robot_usd": 2960,
  "env_usd": 780
 },
 "expires": "2026-09-08T00:00:00Z"
}
```
