Skip to main content
GET
/
v2
/
meetings
List meetings
curl --request GET \
  --url https://api.attio.com/v2/meetings \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": {
        "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
        "meeting_id": "cb59ab17-ad15-460c-a126-0715617c0853"
      },
      "title": "Onboarding Session",
      "description": "Getting you up to speed with the platform and answering any questions you have.",
      "is_all_day": false,
      "start": {
        "datetime": "2027-11-27T14:00:00.000-04:00",
        "timezone": "America/New_York"
      },
      "end": {
        "datetime": "2027-11-27T15:00:00.000-04:00",
        "timezone": "America/New_York"
      },
      "participants": [
        {
          "status": "accepted",
          "is_organizer": false,
          "email_address": "person@company.com"
        }
      ],
      "linked_records": [
        {
          "object_slug": "people",
          "object_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d",
          "record_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d"
        }
      ],
      "created_at": "2023-01-01T15:00:00.000000000Z",
      "created_by_actor": {
        "type": "workspace-member",
        "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
      }
    }
  ],
  "pagination": {
    "next_cursor": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

This API uses OAuth 2.0 with the authorization code grant flow.

Query Parameters

​
limit
integer
default:50

The maximum number of meetings to return. Must be between 1 and 200. Defaults to 50.

Required range: 1 <= x <= 200
Example:

50

​
cursor
string

A pagination cursor used to fetch the next page of meetings. Responses with more meetings will include a cursor for you to use here. If not provided, the first page will be returned.

​
linked_object
string

The object to filter meetings by. Must be a valid object slug or ID. If provided, linked_record_id must also be provided.

Minimum length: 1
​
linked_record_id
string<uuid>

Used to filter meetings to only those values that include a specific linked record. Must be a valid record ID. If provided, linked_object must also be provided.

​
participants
string
default:""

A comma-separated list of emails to filter meetings by. If provided, meetings will be filtered to only include meetings that include at least one of the provided emails as participants.

​
sort
enum<string>
default:start_asc

The order in which to sort the meetings. Defaults to start_asc.

Available options:
start_asc,
start_desc
​
ends_from
string | null

Use ends_from to filter meetings to only those that end after the specified timestamp. ends_from is inclusive, meaning that meetings that end at the exact timestamp will be included in results. When evaluating all-day meetings, we filter results from the perspective of a specific timezone (see timezone for more information).

​
starts_before
string | null

Use starts_before to filter meetings to only those that start before the specified timestamp. starts_before is exclusive, meaning that meetings that start at the exact timestamp will not be included in results. When evaluating all-day meetings, we filter results from the perspective of a specific timezone (see timezone for more information).

​
timezone
string
default:UTC

The timezone to use when filtering meetings using ends_from and starts_before. Defaults to UTC. This property has no effect for non-all-day meetings.

Response

200 - application/json

Success

​
data
object[]
required
​
pagination
object
required