Skip to main content
GET
/
holiday-calendars
/
{id}
Get a holiday calendar
curl --request GET \
  --url https://api.reply.io/v3/holiday-calendars/{id} \
  --header 'X-API-Key: <api-key>'
{
  "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

​
X-API-Key
string
header
required

API key passed in the X-API-Key header

Path Parameters

​
id
integer
required

Holiday calendar ID

Response

Holiday calendar details

Full representation of a holiday calendar including individual holidays.

​
id
integer
required

Unique identifier for the holiday calendar

​
name
string
required

Name of the holiday calendar

​
calendarType
string
required

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

​
countryCode
string
required

ISO 3166-1 alpha-2 country code

​
repeatEveryYear
boolean

Whether the holidays repeat annually

​
holidays
Holiday · object[]

List of holidays in this calendar