Get Cal.com Booking

Checks the status and time of a Cal.com booking.

Unverified

What the model is told

Look up a booking by the uid the customer was given. Returns the title, status (accepted, pending, cancelled), start and end time and location. Use it to confirm a booking exists or when it is.

Request

GEThttps://api.cal.com/v2/bookings/{{bookingUid}}

Headers

cal-api-version2026-02-25
AuthorizationBearer YOUR_CAL_API_KEY

Parameters

bookingUid stringThe booking uid from the confirmation.

Engage payload

{
  "source": "VOICE_AI",
  "tool": {
    "id": "7defa929-93a1-405a-a888-15b3300894be",
    "type": "HTTP_REQUEST",
    "label": "Get Cal.com Booking",
    "name": "get_cal_com_booking",
    "customName": false,
    "description": "Look up a booking by the uid the customer was given. Returns the title, status (accepted, pending, cancelled), start and end time and location. Use it to confirm a booking exists or when it is.",
    "parameters": [
      {
        "name": "bookingUid",
        "type": "string",
        "description": "The booking uid from the confirmation."
      }
    ],
    "config": {
      "endpoint": {
        "method": "GET",
        "url": "https://api.cal.com/v2/bookings/{{bookingUid}}"
      },
      "headers": [
        {
          "name": "cal-api-version",
          "value": "2026-02-25"
        },
        {
          "name": "Authorization",
          "value": "Bearer YOUR_CAL_API_KEY"
        }
      ],
      "body": null,
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.