Skip to main content
GET
/
schedules
/
{scheduleId}
Get Schedule
curl --request GET \
  --url https://api.lemlist.com/api/schedules/{scheduleId} \
  --header 'Authorization: Basic <encoded-value>'
{
  "_id": "skd_AEcaBR4KvwvFtFhyH",
  "name": "Renamed Schedule",
  "secondsToWait": 1000,
  "timezone": "Europe/Berlin",
  "start": "08:00",
  "end": "18:00",
  "weekdays": [
    1,
    2,
    3,
    2,
    5
  ],
  "public": true,
  "teamId": "tea_b4rMsi2trB42WyuWP",
  "createdBy": "usr_gmHgNGRcGPSTJrDbT",
  "createdAt": "2025-10-27T09:41:11.187Z"
}
This endpoint uses the Schedule object.
Fetches the details of a specific schedule based on the given schedule ID.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

scheduleId
string
required

The unique identifier of the schedule

Response

Success

Sending time windows defining when campaigns can send messages (days and hours).

_id
string

Unique schedule identifier

name
string

Schedule name

secondsToWait
integer

Seconds between sends

timezone
string

Schedule timezone (e.g., 'Europe/Paris')

start
string

Daily start time (HH:mm)

end
string

Daily end time (HH:mm)

weekdays
integer[]

Active weekdays (1=Monday, 7=Sunday)

public
boolean

Whether the schedule is available as a template for other users

teamId
string

Unique identifier of the team that owns this schedule

createdBy
string

Unique identifier of the user who created this schedule

createdAt
string<date-time>

Timestamp when the schedule was created

deletedAt
string<date-time>

Timestamp when the schedule was deleted (only present if deleted)

deletedBy
string

Unique identifier of the user who deleted this schedule (only present if deleted)