List Bookings

Retrieves bookings from Cal.com.

GET

Query

Arguments

string

Filter bookings by status.

string

Filter by attendee email.

string

Filter by attendee name.

string

Filter by booking UID.

string

Filter by one event type ID.

string

Comma-separated event type IDs.

string

Filter by one team ID.

string

Comma-separated team IDs.

string

Filter bookings with start after this ISO datetime.

string

Filter bookings with end before this ISO datetime.

string

Filter bookings created after this ISO datetime.

string

Filter bookings created before this ISO datetime.

string

Filter bookings updated after this ISO datetime.

string

Filter bookings updated before this ISO datetime.

string

Sort by start time (`asc` or `desc`).

string

Sort by end time (`asc` or `desc`).

string

Sort by creation time (`asc` or `desc`).

string

Sort by update time (`asc` or `desc`).

number

Number of bookings to return.

number

Number of bookings to skip.

Field selectionChoose which fields should be included in the response. Learn more

string

Comma-separated response fields to include.

Try this request

Request

curl --request GET \
  --url "https://connect.mindcloud.co/v1/universal/cal/latest/actions/list-bookings" \
  --header "Authorization: Bearer $MINDCLOUD_API_TOKEN" \
  --get \
  --data-urlencode 'connectionId=$CONNECTION_ID'

{
  "success": true,
  "data": [
    {
      "attendees": [
        {}
      ],
      "createdAt": "string",
      "description": "string",
      "duration": 1,
      "end": "string",
      "eventTypeId": 1,
      "guests": [
        "string"
      ],
      "id": 1,
      "location": "string",
      "meetingUrl": "https://example.com",
      "metadata": {},
      "start": "string",
      "status": "string",
      "title": "string",
      "uid": "string",
      "updatedAt": "string"
    }
  ],
  "meta": {}
}

Every app you connect,one REST pattern

Call any app with one REST pattern. MindCloud handles each provider's auth, request shape, and responses for you.

Learn what the Universal API is

One REST patternUse the same request structure across apps like Slack, HubSpot, Salesforce, and thousands more.

Managed connectionsSend a MindCloud connection ID instead of handling provider tokens, refresh logic, and credential storage yourself.

Action-level docsEach action page shows the exact endpoint, required arguments, optional controls, and response behavior for that app version.