openapi: 3.0.0 info: title: LeanData BookIt πŸ—“οΈ Availability πŸ—“οΈ Availability πŸ—“οΈ Availability API description: Programmatic scheduling, availability lookup, and meeting management for the LeanData BookIt scheduling product. Power custom UIs with server-to-server access to availability, round-robin, and meeting CRUD. version: 1.0.0 servers: - url: https://api.leandata.com tags: - name: πŸ—“οΈ Availability description: '

The availability endpoints return meeting configuration and open time slots used to render booking pages or refresh availability. Depending on the request context (routing, direct link, or reschedule), the response includes meeting details, eligible hosts, and available time windows.

' paths: /v1/scheduling/route-and-fetch-availability: post: tags: - πŸ—“οΈ Availability summary: v1/scheduling/route-and-fetch-availability description: '

Use this endpoint when you want LeanData BookIt to determine the correct routing outcome (who/what should be booked) and return the current availability of determined host.

Common use cases:

Notes:


πŸ“‹ Pre-Routing Requirements

Before sending form data to the BookIt API, ensure the following requirements are met:

Unique BookIt Log ID


Request Body Parameters


Response Body Parameters

❗️Availability data is returned only when routing.responseType = "calendar"****.
If responseType is "redirect" or "none", the scheduling object will be null, and no availability data will be returned. Always check routing.responseType before accessing scheduling data.

' requestBody: content: application/json: schema: type: object example: triggerNode: New Webform Prospect uid: 3ac6f6f3-2bbd-4401-ab12-0ee9a654b6d1 prospect: Company: LeanData NumEmployees: '500' PhoneNumber: +1(669) 600-5676 ld_bookit_log_id: 3ac6f6f3-2bbd-4401-ab12-0ee9a654b6d1 FirstName: John LastName: Doe Email: johndoe@test.com responses: '200': description: Successful response content: application/json: {} /v1/scheduling/fetch-availability: post: tags: - πŸ—“οΈ Availability summary: v1/scheduling/fetch-availability description: '

Use this endpoint to:


Request Body Parameters

❗️ Important: The request body must include exactly one of the following parameters:


Response Body Parameters

The response structure varies depending on whether the request used token, linkId, or meetingId.

Top-Level Properties

Property Type Description When Returned
calendarEvent object Details of the existing scheduled event (id, title, scheduledTime, attendees, status, organizer). Reschedule flow only (meetingId)
meeting object Meeting metadata (name, duration, required form fields, styling, etc.). All flows
pageInfo object Page-level metadata including hosts and booking behavior flags. All flows
userIdToInfoMap object Map of user ID β†’ user scheduling metadata (name, email, timezone, phone, conference link). All flows
availability object Available time slots and host index mapping. All flows

pageInfo Properties

Property Type Description
displayAllPoolAvailability boolean or null ⚠️ Always check displayAllPoolAvailability before booking.
If true, use POST /v1/round-robin-meeting booking endpoint.
If false, use POST /v1/meeting booking endpoint
userIds string[] Represents defined hosts for the meeting. If userIds is empty, this indicates a pooled availability where the host has not been selected. In this case, the selected time slot determines the host assignment.
nonSFDCUserIds string[] IDs for non-SFDC users included in scheduling (group links only).
prefillFields object Prospect values used to pre-populate the booking form (First Name, Email, etc.).

meeting Object

Property Type Description
name string Display name of the meeting type.
duration object Duration metadata (unit, value).
formFields object[] Fields required to book the meeting.
description string Meeting description shown to the prospect.
redirectURL string Post-booking redirect URL (may be empty).
internalName string Internal meeting type identifier.
pageStyle object Styling metadata (e.g., styleColor).
logo string URL or base64 logo string

availability Object

Property Type Description
indexToUserIdMap object Maps numeric index β†’ user ID.
timeSlots object[] List of available time windows.

timeSlots Structure

Property Type Description
start_time number Start time (Unix timestamp in milliseconds).
end_time number End time (Unix timestamp in milliseconds).
users number[] Array of indices referencing indexToUserIdMap.
' requestBody: content: application/json: schema: type: object example: token: /31AvS7OmROG0U3f1iR1cg/ouvG3T57T0674o0FfVNEDe1oTP0eMWylkgnOmZ7erwPy5Llz+7tYkxuJbyff9PUYdVgKrPk8hkkWlyj6vqa1/Hi3b/ISC9VT2CbG0/vShqEBzU+4MuQv5+0+xCMdnR6i3MK4uwlMK9p7lST6y1FZydHE+VsFj9eZPOxWTKB0lZ5IbFZNJbuvAiA+EJKCPdXw24Z1myG/371ckdjrgwDhFYjGdfXqRRbOQbnyWmXqgjKndHhcwuM4Zn0Qq45+BUnnjKZjyG32qEJaJWLlGQozGQQukcUqupMCzSIyuUgrqpWqFALGbwjf+sYWarqrw/+zKf2n9Jt14/anXkxw1mDWjTVAfnX3PH+XJwIbb/A6mWHe1AjTBtol1M+/6qCWZQwSLrBOiQuO7ySw+Y+F+Y1cfceorE1S6NajM/i7483q5RyMJFsugpiX//KCwBPUIBcP0zola1Uk2KgKc7K03Cq787j5Rlf9yBLs8Z5o2BgT1bY/DqUrTmgOpbIbExnZRX+vltzDQEmIqxsB1kAoC9BbXlWyRsgefyL2Z7nKPeKDxu0FCPO69vMt9AIcmK4TOZQ== responses: '200': description: Successful response content: application/json: {}