Release Candidate — the API is undergoing final validation before general availability, and minor changes may still occur.
Hellomateo API Documentation
DocumentationAPI Reference
Calendars

Get Calendar Blocked Time by External ID

GET
/v1/blocked-times/by

Resolves an immutable, case-sensitive external_id within this organisation and returns the blocked time. Use this endpoint to recover after an ambiguous create timeout before deciding whether to retry POST. Recurring masters and exceptions have distinct external_id values; the master response id is the Mateo UUID used as an exception series_id.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

external_id*string

Identifier assigned by an external system.

Length1 <= length

Response Body

application/json

curl -X GET "https://api.getmateo.com/v1/blocked-times/by?external_id=string"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "calendar_id": "c828ce68-4c5a-4491-b76a-af3d888d3f97",  "source": "manual",  "name": "string",  "external_id": "string",  "is_all_day": true,  "start_at": "2019-08-24T14:15:22Z",  "end_at": "2019-08-24T14:15:22Z",  "recurrence_rule": "string",  "series_id": "0f6582ac-1e7e-41dc-a63a-24fccd074d0c",  "replaces_occurrence_at": "2019-08-24T14:15:22Z"}

Delete Calendar DELETE

Deletes the specified calendar.

Get Calendar by Locator GET

Resolves exactly one of id or external_id within this organisation and returns the calendar. external_id resolves only the partner-owned identifier; the internal provider calendar identifier is never used as a public locator.