Docs
Meetings

List meeting types

GEThttps://api.norreach.app/v1/meeting-types

The 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:truefalse

Response

200application/json— List meeting types

object"list"required
dataobject[]required
Show 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.

StatusCodeMeaning
400bad_requestThe request couldn't be read.
400unknown_fieldThe request has a field this operation doesn't know.
401unauthorizedA valid API key is required.
403insufficient_scopeThis API key doesn't have the scope this operation needs.
403feature_not_enabledThe API isn't switched on for this workspace.
429rate_limitedToo many requests. Slow down and try again.
500server_errorSomething went wrong on our side.
503unavailableThe API isn't available right now. Try again shortly.