Get public holidays by country

Public holidays in Marco include country-level public holidays and state/provincial-level public holidays. Below are examples of public holidays for 2024 at country level and state level

Public Holiday Sample Data

2024 United States country level public holiday

Country	Name	Start Date	End Date
US	New Year's Day	2024-01-01	2024-01-01
US	Martin Luther King, Jr. Day	2024-01-15	2024-01-15
US	George Washington's Birthday	2024-02-19	2024-02-19
US	Memorial Day	2024-03-27	2024-03-27
US	Juneteenth	2024-06-19	2024-06-19
US	Independence Day	2024-07-04	2024-07-04
US	Labor Day	2024-09-02	2024-09-02
US	Columbus Day	2024-10-14	2024-10-14
US	Veterans Day	2024-11-11	2024-11-11
US	Thanksgiving Day	2024-11-28	2024-11-28
US	Christmas Day	2024-12-25	2024-12-25

2024 United States state/province level public holiday: Alabama

State	Name	Start Date	End Date
US-AL	Robert E Lee's Birthday	2024-01-15	2024-01-15
US-AL	Shrove Tuesday	2024-02-23	2024-02-23
US-AL	Confederate Memorial Day	2024-04-22	2024-04-22
US-AL	Jefferson Davis's Birthday	2024-06-03	2024-06-03
US-AL	Mrs. Rosa L. Parks Day	2024-12-01	2024-12-01

Get public holiday

GET /public-holiday

Get public holidays for a given country and state. If parameter state is empty, the endpoint will return the country level public holidays and all the state level's public holidays. Otherwise return country level and this state/province level public holidays.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Required	Description
country	string		Country Code Format: "US" (use ISO 3166 Alpha-2 code)
state	string		State/Province code Format: "US-AL" (use ISO 3166 Alpha-2 code) If state is null, both country level and all state level public holidays are returned. Otherwise return country level and this state/province level public holidays.
start_date	date		Start date for the date range filter, formatted as YYYY/MM/DD. Only public holidays on or after the selected start date will be returned.
end_date	date		End date for the date range filter, formatted as YYYY/MM/DD. Only public holidays on or before the selected end date will be returned.
lang	string		Public holiday language Example: "EN"
pagination	json		Each page returns 50 records. By defualt, the first page data is returned. Example: {"page":2}

Parameter Example

{
  "country": "US",
  "start_date": "2024-01-01",
  "end_date": "2024-05-01",
  "lang": "EN",
  "pagination": {"page":1},
  "state": "US-AL"
}

Response

200

{
    "itemsReceived": 6,
    "curPage": 1,
    "nextPage": null,
    "prevPage": null,
    "offset": 0,
    "itemsTotal": 6,
    "pageTotal": 1,
    "items": [
        {
            "id": 1976,
            "start_date": "2024-01-01",
            "end_date": "2024-01-01",
            "country": "US",
            "state": null,
            "public_holiday_name": "New Year's Day"
        },
        {
            "id": 2038,
            "start_date": "2024-01-15",
            "end_date": "2024-01-15",
            "country": "US",
            "state": null,
            "public_holiday_name": "Martin Luther King, Jr. Day"
        },
        {
            "id": 2183,
            "start_date": "2024-01-15",
            "end_date": "2024-01-15",
            "country": "US",
            "state": "US-AL",
            "public_holiday_name": "Robert E Lee's Birthday"
        },
        {
            "id": 1914,
            "start_date": "2024-02-19",
            "end_date": "2024-02-19",
            "country": "US",
            "state": null,
            "public_holiday_name": "George Washington's Birthday"
        },
        {
            "id": 2184,
            "start_date": "2024-02-23",
            "end_date": "2024-02-23",
            "country": "US",
            "state": "US-AL",
            "public_holiday_name": "Shrove Tuesday"
        },
        {
            "id": 2041,
            "start_date": "2024-04-22",
            "end_date": "2024-04-22",
            "country": "US",
            "state": "US-AL",
            "public_holiday_name": "Confederate Memorial Day"
        }
    ]
}

400