Skip to main content
GET
/
v2.0
/
calendar
List Calendar Events
curl --request GET \
  --url https://api.lofty.com/v2.0/calendar \
  --header 'Authorization: <authorization>'
{
  "data": {
    "total": 100,
    "page": 0,
    "pageSize": 20,
    "items": [
      {
        "id": "12345-task",
        "type": "TASK",
        "taskId": 123,
        "sourceType": 123,
        "content": "<string>",
        "title": "<string>",
        "finished": false,
        "startAt": "<string>",
        "endAt": "<string>",
        "startAtMs": 123,
        "endAtMs": 123,
        "timeZoneCode": "<string>",
        "leadId": 1234567890
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://developer.lofty.com/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
Authorization
string
required

Bearer [access_token]

Query Parameters

​
leadId
string

Lead ID (optional, filter by specific lead)

Example:

123456

​
startTime
string

Start time, ISO 8601 with offset. At least one of startTime or endTime is required.

Example:

"2026-01-01T00:00:00+08:00"

​
endTime
string

End time, ISO 8601 with offset. At least one of startTime or endTime is required.

Example:

"2026-12-31T23:59:59+08:00"

​
startTimeMs
string

Start time as Unix timestamp in milliseconds. Used when startTime is not provided.

Example:

1704038400000

​
endTimeMs
string

End time as Unix timestamp in milliseconds. Used when endTime is not provided.

Example:

1735660799000

​
timeZoneCode
string

Timezone code (IANA format, e.g., America/Los_Angeles)

Example:

"America/Los_Angeles"

​
includeFinished
string
default:false

Include finished calendars

Example:

false

​
page
string
default:0

Page number (starts from 0)

Example:

0

​
pageSize
string

Page size (max 500)

Example:

20

​
sort
string
default:startTime

Sort field (e.g., startTime)

Example:

"startTime"

​
desc
string
default:true

Sort in descending order

Example:

true

​
sourceType
string

Filter by source type codes. Multiple values allowed.

Example:
[1, 2, 4]

Response

Page of calendar entries with pagination metadata.

Response envelope for GET /v2.0/calendar. Wraps the paginated calendar list under the 'data' field.

​
data
object

Calendar list response with pagination