Skip to main content
GET
/
v3
/
holiday-calendars
/
{id}
Get a holiday calendar
curl --request GET \
  --url https://api.reply.io/v3/holiday-calendars/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": 3,
  "name": "US Holidays",
  "calendarType": "custom",
  "countryCode": "US",
  "repeatEveryYear": true,
  "holidays": [
    {
      "id": 100,
      "startDate": "2026-12-25",
      "endDate": "2026-12-25",
      "name": "Christmas Day"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the Reply dashboard: Settings → API Key.

Path Parameters

​
id
integer
required

Holiday calendar ID

Response

Holiday calendar details

Full representation of a holiday calendar including individual holidays.

​
id
integer
read-only

Unique identifier for the holiday calendar

​
name
string

Name of the holiday calendar

​
calendarType
string

Type of calendar (e.g., "predefined", "custom")

​
countryCode
string

ISO 3166-1 alpha-2 country code

​
repeatEveryYear
boolean

Whether the holidays repeat annually

​
holidays
Holiday · object[]

List of holidays in this calendar