List meeting types
GET
https://api.norreach.app/v1/meeting-typesThe kinds of meeting your booking page offers (Intro call, Demo …): length, place, hosts, buffers and notice. Pass one's id to GET /availability and POST /meetings.
meetings:readOperation id: list_meeting_types
GET/meeting-types
curl -X GET "https://api.norreach.app/v1/meeting-types" \
-H "Authorization: Bearer $NORREACH_API_KEY"List meeting types
{
"object": "list",
"data": [
{
"id": "5b6c7d8e-9f0a-4b1c-8d2e-3f4a5b6c7d8e",
"object": "meeting_type",
"slug": "intro",
"name": "Intro call",
"description": null,
"duration_minutes": 30,
"location_kind": "video",
"location_value": null,
"host_mode": "round_robin",
"host_ids": [
"0b6f8a52-8d9e-4c1a-b7f3-5e2d9c4a1b00"
],
"buffer_before_minutes": 0,
"buffer_after_minutes": 10,
"min_notice_minutes": 240,
"window_days": 30,
"max_per_day": null,
"requires_confirmation": false,
"active": true,
"created_at": "2026-10-08T09:00:00.000Z"
}
],
"has_more": false,
"next_cursor": null
}Authorizations
Authorizationstringheaderrequired
Bearer authentication: send Authorization: Bearer <key>, with an API key or an OAuth access token. The key needs the scope meetings:read. API keys and scopes
Query parameters
activeenumquery
Only switched-on (true) or switched-off (false) types.
One of:
truefalseResponse
200application/json— List meeting types
object"list"required
dataobject[]required
Show child attributesHide child attributes
data[].idstring (uuid)required
An id (UUID).
data[].object"meeting_type"required
data[].slugstringrequired
data[].namestringrequired
data[].descriptionstring | nullrequired
data[].duration_minutesnumberrequired
data[].location_kindstring | nullrequired
data[].location_valuestring | nullrequired
data[].host_modestring | nullrequired
round_robin or choose.
data[].host_idsstring (uuid)[]required
data[].buffer_before_minutesnumberrequired
data[].buffer_after_minutesnumberrequired
data[].min_notice_minutesnumberrequired
data[].window_daysnumberrequired
data[].max_per_daynumber | nullrequired
data[].requires_confirmationbooleanrequired
Bookings from the page wait for a person's yes.
data[].activebooleanrequired
data[].created_atstring | nullrequired
has_morebooleanrequired
next_cursorstring | nullrequired
Errors
Errors are application/problem+json with a stable code.
| Status | Code | Meaning |
|---|---|---|
| 400 | bad_request | The request couldn't be read. |
| 400 | unknown_field | The request has a field this operation doesn't know. |
| 401 | unauthorized | A valid API key is required. |
| 403 | insufficient_scope | This API key doesn't have the scope this operation needs. |
| 403 | feature_not_enabled | The API isn't switched on for this workspace. |
| 429 | rate_limited | Too many requests. Slow down and try again. |
| 500 | server_error | Something went wrong on our side. |
| 503 | unavailable | The API isn't available right now. Try again shortly. |