# Dienstpläne auflisten

`GET https://{tenant}.stamp.eu/rest/rosters`

## Query-Parameter

| Name | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `unit_id` | string \| null | nein |  |
| `unit_ids[]` | string[] | nein |  |
| `start` | string | nein | No `sometimes`: the pair has to be complete, and that rule can only fire when the missing half is still validated. |
| `end` | string | nein |  |
| `status` | `draft`, `published`, `archived`, `0`, `1`, `2` \| null | nein |  |

## Antworten

### 200: Array of `RosterResource`

| Feld | Typ | Pflicht |
| --- | --- | --- |
| `data` | object[] | ja |
| `data[].id` | string | ja |
| `data[].name` | string | ja |
| `data[].period_start` | string | ja |
| `data[].period_end` | string | ja |
| `data[].unit_id` | string | ja |
| `data[].status` | string | ja |
| `data[].created_by` | string | ja |
| `data[].notes` | string | ja |
| `data[].budget_cents` | string | ja |
| `data[].entries_count` | integer | nein |
| `data[].created_at` | string | ja |
| `data[].updated_at` | string | ja |

### 401: Unauthenticated

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `message` | string | ja | Error overview. |

### 422: Validation error

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `message` | string | ja | Errors overview. |
| `errors` | object | ja | A detailed description of each field that failed validation. |