Skip to content

List Events

Endpoint

http
GET /unified/calendar/events
Integrations supported
  • Calendly
  • Google Calendar
  • Outlook Calendar
Partial response integrations

For partial response integrations, you will need to fetch the individual resource using the "get" endpoint to get the full response object.

  • Calendly

Query parameters

Refer Specifying query parameters in Truto APIs

integrated_account_id
string · uuid
REQUIRED · The ID of the integrated account to use for the request.
Example: 62f44730-dd91-461e-bd6a-aedd9e0ad79d
truto_response_format
string
The format of the response. Defaults to `unified`. `unified` will return the response with unified mappings applied. `raw` will return the raw response from the remote API. `normalized` will apply the unified mappings and return the data in a normalized format.
All possible enum values:
  • unified
  • raw
  • normalized
Example: unified
truto_key_by
string
By default the `result` attribute is an array of objects. This parameter allows you to specify a field in each `result` objects to use as key, which transforms the `result` array into an object with the array items keyed by the field. This is useful for when you want to use the result as a lookup table.
Example: id
truto_ignore_limit
boolean
Ignores the `limit` query parameter.
truto_ignore_remote_data
boolean
Excludes the `remote_data` attribute from the response.
truto_exclude_fields
array
Array of fields to exclude from the response.
Example: truto_exclude_fields[]=id&truto_exclude_fields[]=name
remote_query
object
Query parameters to pass to the underlying API without any transformations.
Example: remote_query[foo]=bar
calendar
object
The calendar associated with the event.
Required in
  • Google Calendar
  • Outlook Calendar
id
string
The unique identifier of the calendar.
name
string
The name of the calendar.
type
string
The type of the event.
All possible enum values:
  • default
  • focus_time
  • out_of_office
  • working_location
Supported in
  • Google Calendar
identifier
Supported in
  • Google Calendar
sort_by
object
The field to sort the resource by. Should be in format `{ fieldName: direction }`. The direction can be `asc` or `desc`.
Supported in
  • Google Calendar
updated_at
string · date-time
The date when the event was updated.
All possible enum values:
  • asc
  • desc
Supported in
  • Google Calendar
title
string
The title of the event.
Supported in
  • Google Calendar
description
string
The description of the event.
Supported in
  • Google Calendar
location
object
The location of the event.
Supported in
  • Google Calendar
id
string
The unique identifier of the location.
name
string
The name of the location.
address
object
street_1
string
The first line of the street address.
street_2
string
The second line of the street address.
city
string
The city of the address.
state
string
The state of the address.
country
string
The country of the address.
postal_code
string
The postal code of the address.
url
string
The URL of the location.
coordinates
object
latitude
number
The latitude of the location.
longitude
number
The longitude of the location.
organized_by
object
The person who created the event.
Supported in
  • Google Calendar
id
string
The unique identifier of the person.
name
string
The name of the person.
emails
object[]
The emails of the person.
email
string
The email of the person.
type
string
The type of the email.
email
start_time
string · date-time
The date and time when the event starts.
Supported in
  • Google Calendar
end_time
string · date-time
If not specified, fetches events that are within the month of the start_time. If start_time is not specified, fetches events that are till the end of current month.
Supported in
  • Google Calendar
timezone
string
The timezone of the event.
Supported in
  • Google Calendar
updated_at
string · date-time
The date when the event was updated.
Supported in
  • Google Calendar

Response Body

result
object[]
List of Events
id
string
REQUIRED · The unique identifier of the event.
Supported in
  • Calendly
  • Google Calendar
  • Outlook Calendar
calendar
object
The calendar associated with the event.
Supported in
  • Google Calendar
  • Outlook Calendar
id
string
The unique identifier of the calendar.
name
string
The name of the calendar.
title
string
REQUIRED · The title of the event.
Supported in
  • Calendly
  • Google Calendar
  • Outlook Calendar
description
string
The description of the event.
Supported in
  • Google Calendar
  • Outlook Calendar
location
object
The location of the event.
Supported in
  • Calendly
  • Google Calendar
  • Outlook Calendar
id
string
The unique identifier of the location.
name
string
The name of the location.
address
object
street_1
string
The first line of the street address.
street_2
string
The second line of the street address.
city
string
The city of the address.
state
string
The state of the address.
country
string
The country of the address.
postal_code
string
The postal code of the address.
url
string
The URL of the location.
coordinates
object
latitude
number
The latitude of the location.
longitude
number
The longitude of the location.
timezone
string
The timezone of the event.
Supported in
  • Google Calendar
  • Outlook Calendar
start_time
string · date-time
REQUIRED · The date and time when the event starts.
Supported in
  • Calendly
  • Google Calendar
  • Outlook Calendar
end_time
string · date-time
The date and time when the event ends.
Supported in
  • Calendly
  • Google Calendar
  • Outlook Calendar
status
string
The status of the event.
All possible enum values:
  • confirmed
  • tentative
  • cancelled
  • draft
Supported in
  • Calendly
  • Google Calendar
  • Outlook Calendar
attendees
object[]
The attendees associated with the event.
Supported in
  • Calendly
  • Google Calendar
  • Outlook Calendar
person
object
The person associated with the attendee.
id
string
The unique identifier of the person.
name
string
The name of the person.
emails
object[]
The emails of the person.
email
string
The email of the person.
type
string
The type of the email.
is_optional
boolean
Indicates if the attendance is optional.
is_self
boolean
Indicates if the attendee is the authenticated user.
is_organizer
boolean
Indicates if the attendee is the organizer of the event.
response
object
The response of the attendee.
status
string
The status of the response.
All possible enum values:
  • needs_action
  • declined
  • tentative
  • accepted
comment
string
The comment of the response.
created_by
object
The person who created the event.
Supported in
  • Google Calendar
  • Outlook Calendar
id
string
The unique identifier of the person.
name
string
The name of the person.
emails
object[]
The emails of the person.
email
string
The email of the person.
type
string
The type of the email.
organized_by
object
The person who created the event.
Supported in
  • Calendly
  • Google Calendar
  • Outlook Calendar
id
string
The unique identifier of the person.
name
string
The name of the person.
emails
object[]
The emails of the person.
email
string
The email of the person.
type
string
The type of the email.
type
string
The type of the event.
All possible enum values:
  • default
  • out_of_office
  • focus_time
  • working_location
Supported in
  • Calendly
  • Google Calendar
  • Outlook Calendar
availability
string
The availability of the user during the time period of the event.
All possible enum values:
  • busy
  • free
Supported in
  • Google Calendar
  • Outlook Calendar
visibility
string
The visibility of the event.
All possible enum values:
  • calendar_default
  • public
  • private
Supported in
  • Google Calendar
  • Outlook Calendar
identifiers
object
The identifiers associated with the event.
Supported in
  • Google Calendar
  • Outlook Calendar
ical_uid
string
The iCalendar UID of the event.
ical_sequence
string
The iCalendar sequence of the event.
is_locked
boolean
Indicates if the event is locked and cannot be modified.
Supported in
  • Google Calendar
urls
object
The URLs associated with the event.
Supported in
  • Calendly
  • Google Calendar
  • Outlook Calendar
url
string
The URL of the event.
type
string
The type of the URL.
is_recurring
boolean
Indicates if the event is recurring.
Supported in
  • Google Calendar
  • Outlook Calendar
recurrence
string[]
The recurrence of the event. List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event, as specified in RFC5545.
Supported in
  • Google Calendar
  • Outlook Calendar
parent_event
object
The parent event of a recurring event.
Supported in
  • Google Calendar
  • Outlook Calendar
id
string
The unique identifier of the parent event.
has_attachments
boolean
Indicates if the event has attachments.
Supported in
  • Google Calendar
  • Outlook Calendar
attachments
object[]
The attachments associated with the event.
Supported in
  • Google Calendar
id
string
The unique identifier of the attachment.
name
string
The name of the attachment.
mime_type
string
The MIME type of the attachment.
url
string
The URL of the attachment.
created_at
string · date-time
The date when the attachment was created.
updated_at
string · date-time
The date when the attachment was updated.
guests_can_invite_others
boolean
Indicates if guests can invite others to the event.
Supported in
  • Google Calendar
guests_can_modify
boolean
Indicates if guests can modify the event.
Supported in
  • Google Calendar
guests_can_see_other_guests
boolean
Indicates if guests can see other guests of the event.
Supported in
  • Google Calendar
event_type
object
The event type object associated with the event.
Supported in
  • Calendly
id
string
The unique identifier of the event type.
created_at
string · date-time
The date when the event was created.
Supported in
  • Calendly
  • Google Calendar
  • Outlook Calendar
updated_at
string · date-time
The date when the event was updated.
Supported in
  • Calendly
  • Google Calendar
  • Outlook Calendar
remote_data
object
Raw data returned from the remote API call.
next_cursor
string
The cursor to use for the next page of results. Pass this value as `next_cursor` in the query parameter in the next request to get the next page of results.