Menu

Event types

3 endpoints in the Mattering Calendar API.

GET event-types/ User APIService tier

List the org's event types.

Query: space (aliases space_id, workspace_id) narrows to one workspace; active=1 keeps only bookable ones; fields=a,b projects each row to those keys. Capped at 200 rows, newest first.

URL

  • User APIhttps://calendar.mattering.io/api/user/v1/event-types/
  • Service tierhttps://calendar.mattering.io/api/internal/v1/event-types/

Responses

200 data and meta envelope

{
  "data": [
    "..."
  ],
  "meta": {
    "count": 0
  }
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
401unauthorized
404not_found

Example

curl -X GET "https://calendar.mattering.io/api/user/v1/event-types/" \
  -H "Authorization: Bearer $MATTERING_API_KEY"

Source: CalendarCore/internal_api.py (internal_api.event_types)

GET event-types/{code}/ User APIService tier

Read one of the event types by id. derived from route

URL

  • User APIhttps://calendar.mattering.io/api/user/v1/event-types/{code}/
  • Service tierhttps://calendar.mattering.io/api/internal/v1/event-types/{code}/

Path parameters

NameType
codeslug

Responses

200 data and meta envelope

{
  "data": {
    "id": "...",
    "name": "...",
    "description": "...",
    "duration_minutes": "...",
    "location_type": "...",
    "location_details": "...",
    "color": "...",
    "timezone": "...",
    "min_notice_minutes": "...",
    "max_days_ahead": "...",
    "is_active": true,
    "host_email": "...",
    "space_id": "...",
    "booking_path": "...",
    "created_at": "2026-01-01T00:00:00Z",
    "booking_url": "..."
  }
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
401unauthorized
404not_found

Example

curl -X GET "https://calendar.mattering.io/api/user/v1/event-types/CODE/" \
  -H "Authorization: Bearer $MATTERING_API_KEY"

Source: CalendarCore/internal_api.py (internal_api.event_type_detail)

GET event-types/{code}/slots/ User APIService tier

Live availability feed for pickers embedded in sibling apps.

Query: from (alias start_date, YYYY-MM-DD, clamped to today in the host zone), days (1-31, default 7) or its alias end_date (YYYY-MM-DD, INCLUSIVE; the span is capped at 31 days), tz (alias timezone, an IANA zone for the local times). format=compact returns each slot as one local ISO-8601 string instead of the {utc, local} pair.

URL

  • User APIhttps://calendar.mattering.io/api/user/v1/event-types/{code}/slots/
  • Service tierhttps://calendar.mattering.io/api/internal/v1/event-types/{code}/slots/

Path parameters

NameType
codeslug

Responses

200 data and meta envelope

{
  "data": {
    "event_type": "...",
    "timezone": "...",
    "days": [
      {
        "date": "...",
        "slots": [
          {
            "utc": "...",
            "local": "..."
          }
        ]
      }
    ]
  },
  "meta": {
    "from": "2026-01-01T00:00:00Z",
    "num_days": 7,
    "format": "compact"
  }
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
400bad_request
401unauthorized
404not_found
410inactive

Example

curl -X GET "https://calendar.mattering.io/api/user/v1/event-types/CODE/slots/" \
  -H "Authorization: Bearer $MATTERING_API_KEY"

Source: CalendarCore/internal_api.py (internal_api.event_type_slots)

All Calendar resources
Start Free Explore our Products