--- title: Get public holidays slug: api/get-public-holiday description: API reference for GET endpoint: Get public holidays. docTags: createdAt: 2023-12-01T09:43:55.232Z --- :::hint{type="info"} **GET**** /api/public-holiday** ::: Gets all default public holidays for a given country. **Request** *** **Query parameters** *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem **country** string Required ::: :::VerticalSplitItem The country, formatted as an [ISO Alpha-2 code](https://www.iban.com/country-codes). Example: JP ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem **customer\_id** string Required ::: :::VerticalSplitItem The unique Marco identifier for your company. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem **start\_date** string Optional ::: :::VerticalSplitItem Start date for the date range filter, formatted as YYYY/MM/DD. Only public holidays after the selected start date will be returned. Example: 2023/01/31 ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem **end\_date** string Optional ::: :::VerticalSplitItem End date for the date range filter, formatted as YYYY/MM/DD. Only public holidays before the selected end date will be returned. ::: :::: *** **Example Requests** *** ::::CodeDrawer{title="Example" isResponseExpanded="true"} :::CodeblockTabsExamples ```curl curl 'https://api.marcopayroll.com/api:benKoCK8/api/public-holiday?country=PK&customer_id=99&start_date=2023/01/01&end_date=2023/06/30' \ -H 'Authorization: $AUTH_TOKEN' ``` ```python import requests url = "https://api.marcopayroll.com/api:benKoCK8/api/public-holiday?country=PK&customer_id=99&start_date=2023/01/01&end_date=2023/06/30" headers = { "accept": "application/json", "Authorization": "YOUR_AUTH_TOKEN" } response = requests.get(url, headers=headers) print(response.text) ``` ::: :::CodeblockTabsResponses ```javascript { "public_holiday": { "items": [ { "id": 28, "start_date": "2022-02-05", "end_date": "2022-02-05", "country": 178, "created_at": 1660549163339, "updated_at": 1660549163339, "deleted_at": null, "last_modified_by": 326, "dictionary": [ { "key": "data", "lang": "EN", "value": "Kashmir Solidarity Day" }, { "key": "data", "lang": "ZH", "value": "克什米尔团结日" } ] }, { "id": 27, "start_date": "2022-03-23", "end_date": "2022-03-23", "country": 178, "created_at": 1660549139758, "updated_at": 1660549139758, "deleted_at": null, "last_modified_by": 326, "dictionary": [ { "key": "data", "lang": "EN", "value": "Pakistan Day" }, { "key": "data", "lang": "ZH", "value": "巴基斯坦纪念日" } ] }, { "id": 26, "start_date": "2022-05-01", "end_date": "2022-05-01", "country": 178, "created_at": 1660549122938, "updated_at": 1660549122938, "deleted_at": null, "last_modified_by": 326, "dictionary": [ { "key": "data", "lang": "EN", "value": "Labor Day" }, { "key": "data", "lang": "ZH", "value": "劳动节" } ] }, { "id": 25, "start_date": "2022-05-03", "end_date": "2022-05-05", "country": 178, "created_at": 1660549106457, "updated_at": 1660549106458, "deleted_at": null, "last_modified_by": 326, "dictionary": [ { "key": "data", "lang": "EN", "value": "Festival of Breaking the Fast" }, { "key": "data", "lang": "ZH", "value": "斋戒节" } ] } ] "itemsReceived": 4, "curPage": 1, "nextPage": null, "prevPage": null, "itemsTotal": 4, "pageTotal": 1, } } ``` ::: :::: **Response (200)** *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem **{public\_holiday}** object ::: :::VerticalSplitItem The public holidays. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem {public\_holiday}.**items** array\[object\] ::: :::VerticalSplitItem Contains a list of public holidays based on the request parameters. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem items.**id** integer ::: :::VerticalSplitItem The unique Marco identifier for the public holiday. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem items.**start\_date** string ::: :::VerticalSplitItem The start date of the public holiday, formatted as YYYY-MM-DD. Example: 2023-12-31 ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem items.**end\_date** string ::: :::VerticalSplitItem The end date of the public holiday, formatted as YYYY-MM-DD. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem items.**country** integer ::: :::VerticalSplitItem The unique Marco identifier for the country associated to the public holiday. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem items.**created\_at** string ::: :::VerticalSplitItem Unix timestamp for the public holiday's creation date. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem items.**updated\_at** string ::: :::VerticalSplitItem Unix timestamp for the public holiday's update date. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem items.**deleted\_at** string ::: :::VerticalSplitItem Unix timestamp for the public holiday's deletion date. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem items.**last\_modified\_by** integer ::: :::VerticalSplitItem The unique Marco identifier for the user who last modified the public holiday. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem items.**dictionary** array\[object\] ::: :::VerticalSplitItem Contains the public holiday name and its corresponding notes in different languages. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem dictionary.**key** integer ::: :::VerticalSplitItem The type of data. Valid values: data, notes "data" stores the public holiday name, while "notes" stores the public holiday notes. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem dictionary.**lang** integer ::: :::VerticalSplitItem The language that the data or notes are stored in. Example: EN ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem dictionary.**value** integer ::: :::VerticalSplitItem The field value for the data or notes. Example: National Day ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem {public\_holiday}.**itemsReceived** integer ::: :::VerticalSplitItem The number of public holidays returned in the request. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem {public\_holiday}.**curPage** integer ::: :::VerticalSplitItem The current page number. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem {public\_holiday}.**nextPage** integer ::: :::VerticalSplitItem The following page number. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem {public\_holiday}.**prevPage** integer ::: :::VerticalSplitItem The previous page number. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem {public\_holiday}.**itemsTotal** integer ::: :::VerticalSplitItem The total number of public holidays in the response. This number should be the same as `itemsReceived`. ::: :::: *** ::::VerticalSplit{layout="left"} :::VerticalSplitItem {public\_holiday}.**pageTotal** integer ::: :::VerticalSplitItem The total number of pages. ::: :::: ***