GET
/
schedules
/
{id}
Get a schedule
curl --request GET \
  --url https://api.reply.io/v3/schedules/{id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "schedule-123",
  "name": "Business Hours Schedule",
  "schedule": {
    "startDate": "2025-07-01T08:00:00Z",
    "endDate": "2025-12-31T23:59:59Z",
    "timezone": "Europe/Warsaw",
    "workingWindows": [
      {
        "days": [
          1,
          2,
          3,
          4
        ],
        "from": "09:00",
        "to": "17:00"
      },
      {
        "days": [
          5
        ],
        "from": "10:00",
        "to": "18:00"
      }
    ]
  },
  "useContactTimezone": false,
  "skipPublicHolidays": true,
  "publicHolidayRegion": "US",
  "isDefault": true,
  "isActive": true,
  "createdAt": "2024-03-08T14:30:00Z",
  "updatedAt": "2025-06-18T09:21:12Z"
}

Authorizations

X-API-Key
string
header
required

API key passed in the X-API-Key header

Path Parameters

id
string
required

Schedule Id

Response

200 - application/json

Schedule details retrieved successfully

name
string
required

Human-readable schedule name

schedule
object
required

Schedule configuration for sending messages

id
string

Unique identifier for the schedule

useContactTimezone
boolean

Send in each prospect's own time-zone when available

skipPublicHolidays
boolean

Do not send on public holidays in publicHolidayRegion

publicHolidayRegion
string

ISO-3166-1 alpha-2 code (e.g. 'US'). Required when skipPublicHolidays = true

isDefault
boolean

Auto-selected when a sequence has no explicit schedule

isActive
boolean

Disabled schedules are ignored by send engines

createdAt
string<date-time>

ISO-8601 UTC timestamp when created

updatedAt
string<date-time>

ISO-8601 UTC timestamp of last update