# Attendance

## `GET /api/attendance/events`

**ListEvents**

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `kind` | query | {ref}`EventKind <model-eventkind>` \| null | no |  |

**Response `200` — Request fulfilled, document follows**

Model: array of {ref}`AttendanceEventSummary <model-attendanceeventsummary>`

Type: array of {ref}`AttendanceEventSummary <model-attendanceeventsummary>`


## `GET /api/attendance/report`

**GetReport**

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `window` | query | {ref}`AttendanceRange <model-attendancerange>` | no | A reporting window for ``GET /api/attendance/report`` and ``/trends``. |
| `raids_only` | query | boolean | no |  |

**Response `200` — Request fulfilled, document follows**

Model: {ref}`AttendanceReport <model-attendancereport>`

| Field | Type | Required | Description |
|---|---|---|---|
| `range` | {ref}`AttendanceRange <model-attendancerange>` | yes |  |
| `raids_only` | boolean | yes |  |
| `rows` | array of {ref}`MemberAttendanceRow <model-memberattendancerow>` | yes |  |


## `GET /api/attendance/trends`

**GetTrends**

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `window` | query | {ref}`AttendanceRange <model-attendancerange>` | no | A reporting window for ``GET /api/attendance/report`` and ``/trends``. |
| `raids_only` | query | boolean | no |  |

**Response `200` — Request fulfilled, document follows**

Model: {ref}`AttendanceTrends <model-attendancetrends>`

| Field | Type | Required | Description |
|---|---|---|---|
| `range` | {ref}`AttendanceRange <model-attendancerange>` | yes |  |
| `raids_only` | boolean | yes |  |
| `points` | array of {ref}`AttendanceTrendPoint <model-attendancetrendpoint>` | yes |  |


## `GET /api/events/{event_id}/attendance`

**GetAttendance**

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `event_id` | path | string (uuid) | yes |  |

**Response `200` — Request fulfilled, document follows**

Model: {ref}`AttendanceDetail <model-attendancedetail>`

| Field | Type | Required | Description |
|---|---|---|---|
| `event` | {ref}`AttendanceEventSummary <model-attendanceeventsummary>` | yes |  |
| `signups` | array of {ref}`AttendanceSignup <model-attendancesignup>` | yes |  |
| `walk_in_candidates` | array of {ref}`WalkInCandidate <model-walkincandidate>` | yes |  |


## `PUT /api/events/{event_id}/attendance`

**MarkAttendance**

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `event_id` | path | string (uuid) | yes |  |

**Request body**

Model: {ref}`AttendanceMark <model-attendancemark>`

| Field | Type | Required | Description |
|---|---|---|---|
| `entries` | array of {ref}`AttendanceMarkEntry <model-attendancemarkentry>` | no |  |
| `walk_ins` | array of {ref}`WalkInCreate <model-walkincreate>` | no |  |

**Response `200` — Request fulfilled, document follows**

Model: {ref}`AttendanceDetail <model-attendancedetail>`

| Field | Type | Required | Description |
|---|---|---|---|
| `event` | {ref}`AttendanceEventSummary <model-attendanceeventsummary>` | yes |  |
| `signups` | array of {ref}`AttendanceSignup <model-attendancesignup>` | yes |  |
| `walk_in_candidates` | array of {ref}`WalkInCandidate <model-walkincandidate>` | yes |  |


## `PUT /api/guilds/{guild_id}/attendance/voice`

**ReportVoicePresence**

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `guild_id` | path | integer | yes |  |

**Request body**

Model: {ref}`VoicePresenceReport <model-voicepresencereport>`

| Field | Type | Required | Description |
|---|---|---|---|
| `event_id` | string (uuid) | yes |  |
| `entries` | array of {ref}`VoicePresenceEntry <model-voicepresenceentry>` | no |  |

**Response `204`** — Request fulfilled, nothing follows


## `GET /api/guilds/{guild_id}/attendance/voice/{event_id}`

**GetVoicePresence**

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `guild_id` | path | integer | yes |  |
| `event_id` | path | string (uuid) | yes |  |

**Response `200` — Request fulfilled, document follows**

Model: {ref}`VoicePresenceReport <model-voicepresencereport>`

| Field | Type | Required | Description |
|---|---|---|---|
| `event_id` | string (uuid) | yes |  |
| `entries` | array of {ref}`VoicePresenceEntry <model-voicepresenceentry>` | no |  |