Querying for holidays

Use the following endpoints to query for holidays:

  • GET /admin/v1/holidays
  • GET /admin/v1/holidays/{holidayId}

For example, the following request in ClaimCenter retrieves information about holiday cc:SVtboW6sge5-2PbgWx4Ks (Independence Day - United States):

Command
GET /admin/v1/holidays/cc:SVtboW6sge5-2PbgWx4Ks
Response
{
    "data": {
        "attributes": {
            "appliesToAllZones": false,
            "holidayTags": [
                {
                    "code": "FederalHolidays",
                    "name": "Federal Holidays"
                }
            ],
            "id": "cc:SVtboW6sge5-2PbgWx4Ks",
            "name": "Independence Day",
            "occurrenceDate": "2025-07-04T00:00:00.000Z"
        },
        ...