---
title: "List event day-of contacts"
method: GET
path: "/events/{id}/contacts"
tags: ["Events"]
---

# List event day-of contacts

`GET /events/{id}/contacts`

## Request

- Base URL: `https://joinways.app/api/v1`
- URL: `https://joinways.app/api/v1/events/{id}/contacts`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://joinways.app/oauth/authorize`, token URL `https://joinways.app/api/oauth/token`, scopes: `mcp.read`)

Day-of (on-site) contacts of the event: the people reachable during the event itself, distinct from the booking `contact_person_id`. Primary first, then by `sortOrder`. **Role permission:** none (any member).

## Response `200`

Contacts.

- EventContact[]
  - `id` string, uuid
  - `personId` string, uuid, nullable: Linked address-book person, if any.
  - `displayName` string
  - `role` string, nullable
  - `phone` string, nullable
  - `email` string, email, nullable
  - `isOnsite` boolean: Physically present at the venue (vs. reachable remotely).
  - `isPrimary` boolean: The main day-of contact; mirrored to the event's on-site contact.
  - `arrivalTime` string, nullable: Arrival on site (HH:MM).
  - `notes` string, nullable
  - `sortOrder` integer
  - `dayId` string, uuid, nullable: Pins the contact to a specific event day. null = all days.

## Other responses

- `401`: Missing, invalid, expired or revoked bearer token (`unauthorized`).
- `404`: Not found in this workspace, or the id of the path is not a UUID (`not_found`).
- `429`: Too many requests (`rate_limited`). `details.reason`: `per-ip`, `per-account-minute`, `per-account-day`, or `email_rate_limited` (email budget). Always carries `Retry-After`: wait that many seconds.

---

[API](https://skmtc.dev/joinways/apis/joinways-public-api.md) · [All operations](https://skmtc.dev/joinways/apis/joinways-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/joinways/apis/joinways-public-api/revisions/39e84309953e?raw)