Indonesian Holidays

National and regional public holidays in Indonesia.

Product pagePostman collectionOpenAPI spec

Base URL

https://use.api.co.id

All endpoints live under the /holidays/indonesia path and are called with the x-api-co-id header. Filters such as year, month, date, or holiday type are sent as query parameters. The response contains holiday names, dates, and categories.

Holiday types

The data covers public holidays, joint holidays, national holidays, and observances. Use these values in the type parameter:

type value	Meaning
Public Holiday	Public holiday
Joint Holiday	Joint (collective leave) holiday
National Holiday	National holiday
Observance	Observance

Features

Need	Endpoint
List holidays with comprehensive filters	/holidays/indonesia/
Check whether a specific date is a holiday	/holidays/indonesia/check/date
Holidays within a date range	/holidays/indonesia/check/range
Next holiday, with countdown	/holidays/indonesia/next
List of upcoming holidays	/holidays/indonesia/upcoming
Holiday statistics and long weekend detection	/holidays/indonesia/stats
Monthly calendar view	/holidays/indonesia/calendar
Available years and holiday types	/holidays/indonesia/years, /holidays/indonesia/types

Core Endpoints

List Holidays

GET/holidays/indonesia/

Get all holidays with comprehensive filtering options. Supports filtering by year, month, type, date range, with pagination support. Note: Pagination size is fixed at 100 items per page and cannot be configured.

Query parameters

Name	Type	Description
yearOptional	integer	Filter by year Example: 2025
monthOptional	integer	Filter by month (1-12) Example: 1
typeOptional	string	Filter by holiday type Values: Public HolidayJoint HolidayNational HolidayObservance Example: Public Holiday
start_dateOptional	string	Filter holidays from this date (YYYY-MM-DD) Example: 2025-01-01
end_dateOptional	string	Filter holidays until this date (YYYY-MM-DD) Example: 2025-12-31
pageOptional	integer	Page number Example: 1

Response fields

Name	Type	Description
is_successOptional	boolean	Example: true
messageOptional	string	Example: Success
dataOptional	object[]
data[].idOptional	string	Holiday ID Example: holiday_2025_01_01
data[].dateOptional	string	Holiday date (YYYY-MM-DD) Example: 2025-01-01
data[].nameOptional	string	Holiday name Example: Tahun Baru 2025
data[].typeOptional	string	Holiday type Example: Public Holiday
data[].is_national_holidayOptional	boolean	Whether it's a national holiday Example: true
pagingOptional	object
paging.pageOptional	integer	Example: 1
paging.sizeOptional	integer	Example: 100
paging.total_itemOptional	integer	Example: 20
paging.total_pageOptional	integer	Example: 1

Request

curl -X GET "https://use.api.co.id/holidays/indonesia/" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccess - Holidays Listed

{  "is_success": true,  "message": "Success",  "data": [    {      "id": "holiday_2025_01_01",      "date": "2025-01-01",      "name": "Tahun Baru 2025",      "type": "Public Holiday",      "is_national_holiday": true    },    {      "id": "holiday_2025_01_17",      "date": "2025-01-17",      "name": "Hari Raya Idul Fitri 1446 H",      "type": "National Holiday",      "is_national_holiday": true    }  ],  "paging": {    "page": 1,    "size": 100,    "total_item": 20,    "total_page": 1  }}

Get Holiday by ID

GET/holidays/indonesia/{id}

Get a single holiday by its ID.

Path parameters

Name	Type	Description
idRequired	string	Holiday ID Example: holiday_2025_01_01

Request

curl -X GET "https://use.api.co.id/holidays/indonesia/holiday_2025_01_01" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccess - Holiday Retrieved

{  "is_success": true,  "message": "Success",  "data": {    "id": "holiday_2025_01_01",    "date": "2025-01-01",    "name": "Tahun Baru 2025",    "type": "Public Holiday",    "is_national_holiday": true,    "description": "Hari libur nasional Tahun Baru 2025"  }}

Date Checking

Check Date

GET/holidays/indonesia/check/date

Check if a specific date is a holiday.

Query parameters

Name	Type	Description
dateRequired	string	Date to check (YYYY-MM-DD) Example: 2025-01-01

Request

curl -X GET "https://use.api.co.id/holidays/indonesia/check/date?date=2025-01-01" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccess - Date Checked

{  "is_success": true,  "message": "Success",  "data": {    "date": "2025-01-01",    "is_holiday": true,    "holiday": {      "id": "holiday_2025_01_01",      "name": "Tahun Baru 2025",      "type": "Public Holiday"    }  }}

Check Date Range

GET/holidays/indonesia/check/range

Get all holidays within a date range.

Query parameters

Name	Type	Description
start_dateRequired	string	Start date (YYYY-MM-DD) Example: 2025-01-01
end_dateRequired	string	End date (YYYY-MM-DD) Example: 2025-01-31
typeOptional	string	Filter by holiday type Values: Public HolidayJoint HolidayNational HolidayObservance Example: Public Holiday

Request

curl -X GET "https://use.api.co.id/holidays/indonesia/check/range?start_date=2025-01-01&end_date=2025-01-31" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccess - Holidays in Range

{  "is_success": true,  "message": "Success",  "data": [    {      "id": "holiday_2025_01_01",      "date": "2025-01-01",      "name": "Tahun Baru 2025",      "type": "Public Holiday"    },    {      "id": "holiday_2025_01_17",      "date": "2025-01-17",      "name": "Hari Raya Idul Fitri 1446 H",      "type": "National Holiday"    }  ],  "total": 2}

Upcoming & Next Holiday

Get Next Holiday

GET/holidays/indonesia/next

Get the next upcoming holiday with countdown information.

Query parameters

Name	Type	Description
typeOptional	string	Filter by holiday type Values: Public HolidayJoint HolidayNational HolidayObservance Example: Public Holiday

Request

curl -X GET "https://use.api.co.id/holidays/indonesia/next" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccess - Next Holiday Retrieved

{  "is_success": true,  "message": "Success",  "data": {    "id": "holiday_2025_01_01",    "date": "2025-01-01",    "name": "Tahun Baru 2025",    "type": "Public Holiday",    "days_until": 15,    "countdown": "15 days until Tahun Baru 2025"  }}

Get Upcoming Holidays

GET/holidays/indonesia/upcoming

Get a list of upcoming holidays with optional limit.

Query parameters

Name	Type	Description
limitOptional	integer	Maximum number of upcoming holidays to return Example: 5
typeOptional	string	Filter by holiday type Values: Public HolidayJoint HolidayNational HolidayObservance Example: Public Holiday

Request

curl -X GET "https://use.api.co.id/holidays/indonesia/upcoming" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccess - Upcoming Holidays Retrieved

{  "is_success": true,  "message": "Success",  "data": [    {      "id": "holiday_2025_01_01",      "date": "2025-01-01",      "name": "Tahun Baru 2025",      "type": "Public Holiday",      "days_until": 15    },    {      "id": "holiday_2025_01_17",      "date": "2025-01-17",      "name": "Hari Raya Idul Fitri 1446 H",      "type": "National Holiday",      "days_until": 31    }  ],  "total": 2}

Statistics & Analytics

Get Holiday Statistics

GET/holidays/indonesia/stats

Get holiday statistics including long weekend detection for a specific year.

Query parameters

Name	Type	Description
yearRequired	integer	Year to get statistics for Example: 2025

Request

curl -X GET "https://use.api.co.id/holidays/indonesia/stats?year=2025" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccess - Statistics Retrieved

{  "is_success": true,  "message": "Success",  "data": {    "year": 2025,    "total_holidays": 20,    "public_holidays": 15,    "national_holidays": 5,    "long_weekends": [      {        "date": "2025-01-01",        "name": "Tahun Baru 2025",        "type": "Public Holiday"      },      {        "date": "2025-01-17",        "name": "Hari Raya Idul Fitri 1446 H",        "type": "National Holiday"      }    ],    "total_long_weekends": 2  }}

Get Holiday Calendar

GET/holidays/indonesia/calendar

Get holidays for a specific month in calendar format.

Query parameters

Name	Type	Description
yearRequired	integer	Year Example: 2025
monthRequired	integer	Month (1-12) Example: 1

Request

curl -X GET "https://use.api.co.id/holidays/indonesia/calendar?year=2025&month=1" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccess - Calendar Retrieved

{  "is_success": true,  "message": "Success",  "data": {    "year": 2025,    "month": 1,    "holidays": [      {        "date": "2025-01-01",        "name": "Tahun Baru 2025",        "type": "Public Holiday"      },      {        "date": "2025-01-17",        "name": "Hari Raya Idul Fitri 1446 H",        "type": "National Holiday"      }    ],    "total": 2  }}

Metadata

Get Available Years

GET/holidays/indonesia/years

Get all years that have holiday data in the database.

Request

curl -X GET "https://use.api.co.id/holidays/indonesia/years" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccess - Years Retrieved

{  "is_success": true,  "message": "Success",  "data": [    2020,    2021,    2022,    2023,    2024,    2025,    2026  ],  "total": 7}

Get Holiday Types

GET/holidays/indonesia/types

Get all available holiday types with descriptions.

Request

curl -X GET "https://use.api.co.id/holidays/indonesia/types" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccess - Types Retrieved

{  "is_success": true,  "message": "Success",  "data": [    {      "type": "Public Holiday",      "description": "Public holiday observed nationwide"    },    {      "type": "Joint Holiday",      "description": "Joint holiday observed by multiple regions"    },    {      "type": "National Holiday",      "description": "National holiday of significant importance"    },    {      "type": "Observance",      "description": "Cultural or religious observance"    }  ],  "total": 4}