API Reference/Endpoints
List events in a calendar
GET/api/linkedin/gateway/calendars/{calendar_id}/events
Lists events on one calendar, with filters for a time window, attendee, title, location and more.
Authentication
Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.
Path parameters
FieldTypeDescription
calendar_id *stringThe calendar to list events from.
Query parameters
FieldTypeDescription
account_id *stringThe connected account the calendar belongs to.
startstringRFC 3339 — only events starting after this instant.
endstringRFC 3339 — only events ending before this instant.
expand_recurringbooleanExpand a recurring series into its individual occurrences.
event_typestringComma-separated list of event types to keep.
attendeesstringComma-separated attendee emails to filter by.
updated_afterstringRFC 3339 — only events last updated after this instant.
updated_beforestringRFC 3339 — only events last updated before this instant.
busybooleanOnly events marked as busy time.
locationstringOnly events matching this location.
ical_uidstringOnly the event with this iCal UID.
descriptionstringOnly events matching this description.
titlestringOnly events matching this title.
is_cancelledbooleanInclude cancelled events.
cursorstringPagination cursor from a previous page's next_cursor.
offsetnumberAn offset-based alternative to cursor, on providers that support it.
limitnumberPage size.
Response fields
FieldTypeDescription
dataarrayEach event: id, title, body, location, is_cancelled, is_all_day, attendees, start, end, organizer, conference, visibility and transparency.
next_cursorstringPass as cursor on the next call to page forward.
Errors
·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. The account_id doesn't belong to this key.·404 Not Found. No calendar with that id belongs to this account.
