# ticket_tier_labels_get
Lists the tier labels (seat grades) by status and page, or checks a title, color or archive change before it is made. Read only.
## Inputs
| Field | Required here | Contract |
| --- | --- | --- |
| `view` | Yes | one of: `list`, `prepare` (by `kind`) |
| `view.status` | No | When `view.kind` is `list`: `LISTED`, `ARCHIVED`; default `LISTED` |
| `view.page` | No | When `view.kind` is `list`: integer; minimum 1; maximum 10000; default `1` |
| `view.operation` | Yes | When `view.kind` is `prepare`: one of: `edit`, `status` (by `kind`) |
| `view.operation.tierLabelId` | Yes | When `view.kind` is `prepare` and `view.operation.kind` is `edit`: string; min length 1; max length 160; pattern `^[A-Za-z0-9_-]+$`; Exact resource identifier returned by this operation, never a title, unrelated row ID or URL. |
| `view.operation.settings` | Yes | When `view.kind` is `prepare` and `view.operation.kind` is `edit`: object |
| `view.operation.settings.title` | No | When `view.kind` is `prepare` and `view.operation.kind` is `edit`: string; min length 2; max length 20 |
| `view.operation.settings.color` | No | When `view.kind` is `prepare` and `view.operation.kind` is `edit`: `#FF4343`, `#FF8200`, `#FFE21E`, `#B2F200`, `#08DD00`, `#25C6F3`, `#4B63FF`, `#9842FC`, `#FF33CD`, `#FB9C96`, `#FFC78C`, `#FCEE91`, `#DCF989`, `#A3F7A0`, `#95E1F7`, `#A0ADFF`, `#C9A1F8`, `#FAA6E5` |
| `view.operation.tierLabelIds` | Yes | When `view.kind` is `prepare` and `view.operation.kind` is `status`: array; items: string; min length 1; max length 160; pattern `^[A-Za-z0-9_-]+$`; Exact resource identifier returned by this operation, never a title, unrelated row ID or URL.; min items 1; max items 100 |
| `view.operation.status` | Yes | When `view.kind` is `prepare` and `view.operation.kind` is `status`: `LISTED`, `ARCHIVED` |
| `view.operation.confirmation` | Yes | When `view.kind` is `prepare` and `view.operation.kind` is `status`: `CHANGE_TIER_LABEL_STATUS` |
## Usage
- `view:{kind:"list", status, page}` lists tier labels with status `LISTED` (default) or `ARCHIVED`, 100 per page.
- `view:{kind:"prepare", operation:{kind:"edit", tierLabelId, settings}}` reads one label (empty `settings`) or checks a new title (2–20) or color (one of the 18 console colors).
- `view:{kind:"prepare", operation:{kind:"status", tierLabelIds, status, confirmation:"CHANGE_TIER_LABEL_STATUS"}}` checks moving up to 100 labels between `LISTED` and `ARCHIVED`.
A check reads both complete lists (at most 500 labels together) and the selected labels.
```json
{"view": {"kind": "list", "status": "LISTED", "page": 1}}
```
## Results
Nothing changes, and no example data is shown when the service cannot be read. Labels used by price policies or seat templates follow their own rules; the service can refuse archiving a label in use. [ticket_tier_label_apply](ticket_tier_label_apply.md) runs the same check in its preview.
