# RunLaneWait

Whether a run is waiting for a lane before it starts, and why. A waiting run is in status `New`; see "How many run at once" in the limits concept.

**Kind:** an object, used in responses.

## Fields

Every field is present in a response; empty ones are `null`.

| Field | Type | Description |
|---|---|---|
| `processId` | `uuid` | The run's id. |
| `processType` | [`ProcessType`](https://docs.maitento.com/reference/types/process-type.md) | What kind of run it is. |
| `waiting` | `boolean` | True while the run waits for a lane. Every other field is null when it isn't waiting. |
| `waitingSinceUtc` | `datetime \| null` | When it started waiting, in UTC. |
| `lane` | [`LaneType`](https://docs.maitento.com/reference/types/lane-type.md)`\| null` | The kind of lane it waits for. |
| `reason` | [`LaneWaitReason`](https://docs.maitento.com/reference/types/lane-wait-reason.md)`\| null` | Why it's waiting. |
| `lanesInUse` | `integer \| null` | How many of your lanes of this kind are in use. Null for a run an app started, which doesn't take a lane to wait. |
| `laneLimit` | `integer \| null` | How many lanes of this kind your plan includes. Null when there's no limit, or for a run an app started. |
| `ahead` | `integer \| null` | How many of your runs of this kind are waiting ahead of it. Null for a run an app started. |

## Example

```json
{
  "processId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "processType": "App",
  "waiting": false,
  "waitingSinceUtc": "2026-10-26T12:00:00.0000000Z",
  "lane": "Standard",
  "reason": "LanesInUse",
  "lanesInUse": 0,
  "laneLimit": 0,
  "ahead": 0
}
```

## Where it's used

- [`runs.lane`](https://docs.maitento.com/reference/api/runs.md) (`GET /processes/{processType}/{processId}/lane`)