Get events
GET {{baseUrl}}/:calendarKeyOrId/events?startDate=2024-04-01&endDate=2024-04-07&tz=America/London
Read events for a date range.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
startDate | string | The start date of the date range. In YYYY-MM-DD format. If not specified, it defaults to the current date | |
endDate | string | The end date of the date range (inclusive). In YYYY-MM-DD format. If not specified it defaults to the start date. | |
tz | string | The timezone in which event times are returned. If not specified, it defaults to the default timezone of the calendar. For a full list of supported timezone identifiers see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones. | |
| We recommend using only timezones of type "Canonical". |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string | ||
Teamup-Token | string |
RESPONSES
status: OK
{"events":[{"id":"1663905322","series_id":null,"remote_id":null,"subcalendar_id":13142978,"subcalendar_ids":[13142978],"all_day":true,"rrule":"","title":"Mark OOO","who":"","location":"","notes":"","version":"4e0b7cd2728b","readonly":false,"tz":null,"attachments":[],"start_dt":"2024-04-01T00:00:00","end_dt":"2024-04-01T23:59:59","ristart_dt":null,"rsstart_dt":null,"creation_dt":"2024-04-03T17:27:17+01:00","update_dt":null,"delete_dt":null,"custom":{"type":["sick_leave"]}},{"id":"1663905312","series_id":null,"remote_id":null,"subcalendar_id":13142979,"subcalendar_ids":[13142979],"all_day":true,"rrule":"","title":"Sandy in Berlin","who":"","location":"","notes":"\u003cp\u003eFlight AA808 at 7:40am, return AA809 at 5:50pm\u003c/p\u003e","version":"ed4416433317","readonly":false,"tz":null,"attachments":[],"start_dt":"2024-04-01T00:00:00","end_dt":"2024-04-08T23:59:59","ristart_dt":null,"rsstart_dt":null,"creation_dt":"2024-04-03T17:27:17+01:00","update_dt":null,"delete_dt":null,"custom":{"type":["business_travel"]}},{"id":"1663905315-rid-1711980000","series_id":1663905315,"remote_id":null,"subcalendar_id":13142980,"subcalendar_ids":[13142980],"all_day":false,"rrule":"FREQ=WEEKLY","title":"Weekly Team Mtg.","who":"","location":"Conf. Rm. 1","notes":"","version":"b393161fe6bf","readonly":false,"tz":null,"attachments":[],"start_dt":"2024-04-01T15:00:00+01:00","end_dt":"2024-04-01T16:00:00+01:00","ristart_dt":"2024-04-01T14:00:00+00:00","rsstart_dt":"2024-04-01T15:00:00+01:00","creation_dt":"2024-04-03T17:27:17+01:00","update_dt":null,"delete_dt":null},{"id":"1663905313","series_id":null,"remote_id":null,"subcalendar_id":13142976,"subcalendar_ids":[13142976],"all_day":true,"rrule":"","title":"Frank vacation","who":"","location":"","notes":"\u003cp\u003eIn case of emergencies I am reachable at 708 5676 456.\u003c/p\u003e","version":"0f9db0347304","readonly":false,"tz":null,"attachments":[],"start_dt":"2024-04-02T00:00:00","end_dt":"2024-04-10T23:59:59","ristart_dt":null,"rsstart_dt":null,"creation_dt":"2024-04-03T17:27:17+01:00","update_dt":null,"delete_dt":null,"custom":{"type":["annual_leave_pto"]}},{"id":"1663905323","series_id":null,"remote_id":null,"subcalendar_id":13142977,"subcalendar_ids":[13142977],"all_day":true,"rrule":"","title":"Home Office","who":"","location":"","notes":"","version":"746cc32c0731","readonly":false,"tz":null,"attachments":[],"start_dt":"2024-04-02T00:00:00","end_dt":"2024-04-03T23:59:59","ristart_dt":null,"rsstart_dt":null,"creation_dt":"2024-04-03T17:27:18+01:00","update_dt":null,"delete_dt":null}],"timestamp":1712561549}