# Away Reasons

## List managed away reasons

**get** `/v2/away-reasons`

Returns active managed away reasons. Set includeArchived=true to include historical reasons.

### Header Parameters

- `"Featurebase-Version": optional "2026-08-19.orbit" or "2026-01-01.nova" or "2025-12-12.clover"`

  - `"2026-08-19.orbit"`

  - `"2026-01-01.nova"`

  - `"2025-12-12.clover"`

### Returns

- `data: array of object { id, archived, label, object }`

  - `id: string`

  - `archived: boolean`

  - `label: string`

  - `object: "away_reason"`

    - `"away_reason"`

- `nextCursor: unknown`

- `object: "list"`

  - `"list"`

### Example

```http
curl https://do.featurebase.app/v2/away-reasons \
    -H "Authorization: Bearer $FEATUREBASE_API_KEY"
```

#### Response

```json
{
  "data": [
    {
      "id": "id",
      "archived": true,
      "label": "label",
      "object": "away_reason"
    }
  ],
  "nextCursor": null,
  "object": "list"
}
```

## Domain Types

### Away Reason Retrieve Away Reasons Response

- `AwayReasonRetrieveAwayReasonsResponse object { data, nextCursor, object }`

  - `data: array of object { id, archived, label, object }`

    - `id: string`

    - `archived: boolean`

    - `label: string`

    - `object: "away_reason"`

      - `"away_reason"`

  - `nextCursor: unknown`

  - `object: "list"`

    - `"list"`