{"info":{"_postman_id":"ec837932-5bef-4e0c-b1ab-411cf67e636f","name":"Indonesian Holidays API","description":"

Complete API collection for accessing Indonesian public holidays, joint holidays, national holidays, and observances.

\n

Authentication

\n

All requests require an API key in the x-api-co-id header.

\n

Features

\n\n

Base URL

\n
https://use.api.co.id/holidays/indonesia\n
","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"50289783","collectionId":"ec837932-5bef-4e0c-b1ab-411cf67e636f","publishedId":"2sB3dHVskD","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-11-23T11:31:38.000Z"},"item":[{"name":"Core Endpoints","item":[{"name":"List All Holidays (Current Year)","id":"65613992-593f-40ff-93e5-503a58450a17","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/","description":"

Get all holidays for the current year. If no filters are provided, defaults to current year.

\n","urlObject":{"path":["holidays","indonesia",""],"host":["https://use.api.co.id"],"query":[],"variable":[]}},"response":[],"_postman_id":"65613992-593f-40ff-93e5-503a58450a17"},{"name":"List Holidays by Year","id":"09a5fd43-9ba7-4158-b16e-4f7fb9a3c04b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/?year=2025","description":"

Get all holidays for a specific year.

\n","urlObject":{"path":["holidays","indonesia",""],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Year to filter (e.g., 2025)

\n","type":"text/plain"},"key":"year","value":"2025"}],"variable":[]}},"response":[{"id":"2b747460-e4ae-471e-a6a5-62a1483baf89","name":"Success - 2025 Holidays","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":{"raw":"https://use.api.co.id/holidays/indonesia/?year=2025&size=3","host":["https://use.api.co.id"],"path":["holidays","indonesia",""],"query":[{"key":"year","value":"2025"},{"key":"size","value":"3"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": [\n {\n \"id\": 1,\n \"date\": \"2025-01-01\",\n \"date_formatted\": \"1 Januari 2025\",\n \"day_of_week\": \"Rabu\",\n \"name\": \"Tahun Baru Masehi\",\n \"type\": \"Public Holiday\",\n \"year\": 2025,\n \"is_today\": false,\n \"is_upcoming\": true,\n \"days_until\": 44,\n \"is_holiday\": true,\n \"is_joint_holiday\": false,\n \"is_observance\": false\n },\n {\n \"id\": 2,\n \"date\": \"2025-01-29\",\n \"date_formatted\": \"29 Januari 2025\",\n \"day_of_week\": \"Rabu\",\n \"name\": \"Tahun Baru Imlek\",\n \"type\": \"Public Holiday\",\n \"year\": 2025,\n \"is_today\": false,\n \"is_upcoming\": true,\n \"days_until\": 72,\n \"is_holiday\": true,\n \"is_joint_holiday\": false,\n \"is_observance\": false\n },\n {\n \"id\": 3,\n \"date\": \"2025-03-29\",\n \"date_formatted\": \"29 Maret 2025\",\n \"day_of_week\": \"Sabtu\",\n \"name\": \"Hari Raya Nyepi\",\n \"type\": \"Public Holiday\",\n \"year\": 2025,\n \"is_today\": false,\n \"is_upcoming\": true,\n \"days_until\": 131,\n \"is_holiday\": true,\n \"is_joint_holiday\": false,\n \"is_observance\": false\n }\n ],\n \"paging\": {\n \"page\": 1,\n \"size\": 3,\n \"total_item\": 23,\n \"total_page\": 8\n }\n}"}],"_postman_id":"09a5fd43-9ba7-4158-b16e-4f7fb9a3c04b"},{"name":"List Holidays by Year and Month","id":"33a18b21-0dbf-4a6d-ab84-64c44bb8436d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/?year=2025&month=1","description":"

Get holidays for a specific month in a year.

\n","urlObject":{"path":["holidays","indonesia",""],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Year (e.g., 2025)

\n","type":"text/plain"},"key":"year","value":"2025"},{"description":{"content":"

Month (1-12)

\n","type":"text/plain"},"key":"month","value":"1"}],"variable":[]}},"response":[],"_postman_id":"33a18b21-0dbf-4a6d-ab84-64c44bb8436d"},{"name":"List Public Holidays Only","id":"f8c33d64-5ced-4ca2-bfc5-0d1249b16c32","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/?year=2025&type=Public Holiday","description":"

Get only public holidays (work day off).

\n","urlObject":{"path":["holidays","indonesia",""],"host":["https://use.api.co.id"],"query":[{"key":"year","value":"2025"},{"description":{"content":"

Filter by type: Public Holiday, Joint Holiday, National Holiday, Observance

\n","type":"text/plain"},"key":"type","value":"Public Holiday"}],"variable":[]}},"response":[],"_postman_id":"f8c33d64-5ced-4ca2-bfc5-0d1249b16c32"},{"name":"Search Holidays by Name","id":"266d3c15-345e-4164-8517-da988e770e72","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/?name=Idul Fitri&year=2025","description":"

Search holidays by name. Performs case-insensitive partial matching.

\n","urlObject":{"path":["holidays","indonesia",""],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Search by holiday name (case-insensitive)

\n","type":"text/plain"},"key":"name","value":"Idul Fitri"},{"key":"year","value":"2025"}],"variable":[]}},"response":[],"_postman_id":"266d3c15-345e-4164-8517-da988e770e72"},{"name":"Get Upcoming Holidays Only","id":"929c92c2-9e56-4e74-8350-5587ea89fb0a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/?upcoming=true","description":"

Get only upcoming holidays from today onwards.

\n","urlObject":{"path":["holidays","indonesia",""],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Only show upcoming holidays from today

\n","type":"text/plain"},"key":"upcoming","value":"true"}],"variable":[]}},"response":[],"_postman_id":"929c92c2-9e56-4e74-8350-5587ea89fb0a"},{"name":"Get Holiday by ID","id":"eee135f7-b390-478d-874b-317d41427c9c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/:id","description":"

Get a single holiday by its ID.

\n","urlObject":{"path":["holidays","indonesia",":id"],"host":["https://use.api.co.id"],"query":[],"variable":[{"id":"04134ea7-7d43-463b-a963-15b6d0ae85aa","description":{"content":"

Holiday ID

\n","type":"text/plain"},"type":"any","value":"1","key":"id"}]}},"response":[{"id":"1c78a649-243d-428b-8690-c3348fc97336","name":"Success - Holiday Found","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"id\": 1,\n \"date\": \"2025-01-01\",\n \"date_formatted\": \"1 Januari 2025\",\n \"day_of_week\": \"Rabu\",\n \"name\": \"Tahun Baru Masehi\",\n \"type\": \"Public Holiday\",\n \"year\": 2025,\n \"is_today\": false,\n \"is_upcoming\": true,\n \"days_until\": 44,\n \"is_holiday\": true,\n \"is_joint_holiday\": false,\n \"is_observance\": false\n }\n}"},{"id":"c2311f84-f1cc-4445-90b5-d4b8e2236518","name":"Error - Not Found","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/99999"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"holiday not found\",\n \"data\": null\n}"}],"_postman_id":"eee135f7-b390-478d-874b-317d41427c9c"}],"id":"fed68be7-df7b-43c0-b530-203a016f0ba4","description":"

Core endpoints for listing and retrieving holidays with various filters.

\n","_postman_id":"fed68be7-df7b-43c0-b530-203a016f0ba4"},{"name":"Date Checking","item":[{"name":"Check if Date is Holiday","id":"65ef5e07-26ca-497e-9f5f-23159a4bde89","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/check/date?date=2025-01-01","description":"

Check if a specific date is a holiday. Returns holiday details if found, plus day of week and weekend status.

\n","urlObject":{"path":["holidays","indonesia","check","date"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Date to check (YYYY-MM-DD format)

\n","type":"text/plain"},"key":"date","value":"2025-01-01"}],"variable":[]}},"response":[{"id":"413034c6-32c5-4190-9b81-9eae1d0b6d6d","name":"Success - Date is Holiday","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":{"raw":"https://use.api.co.id/holidays/indonesia/check/date?date=2025-01-01","host":["https://use.api.co.id"],"path":["holidays","indonesia","check","date"],"query":[{"key":"date","value":"2025-01-01"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"date\": \"2025-01-01\",\n \"is_holiday\": true,\n \"day_of_week\": \"Wednesday\",\n \"is_weekend\": false,\n \"holidays\": [\n {\n \"id\": 1,\n \"date\": \"2025-01-01\",\n \"date_formatted\": \"1 Januari 2025\",\n \"day_of_week\": \"Rabu\",\n \"name\": \"Tahun Baru Masehi\",\n \"type\": \"Public Holiday\",\n \"year\": 2025,\n \"is_today\": false,\n \"is_upcoming\": true,\n \"days_until\": 44,\n \"is_holiday\": true,\n \"is_joint_holiday\": false,\n \"is_observance\": false\n }\n ]\n }\n}"},{"id":"84ff545c-45dd-4b0a-ae9c-8307b4eb3a40","name":"Success - Not a Holiday","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":{"raw":"https://use.api.co.id/holidays/indonesia/check/date?date=2025-01-15","host":["https://use.api.co.id"],"path":["holidays","indonesia","check","date"],"query":[{"key":"date","value":"2025-01-15"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"date\": \"2025-01-15\",\n \"is_holiday\": false,\n \"day_of_week\": \"Wednesday\",\n \"is_weekend\": false\n }\n}"}],"_postman_id":"65ef5e07-26ca-497e-9f5f-23159a4bde89"},{"name":"Get Holidays in Date Range","id":"aba599ff-c7a7-42fe-b2a9-e1bd808fa696","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/check/range?start_date=2025-01-01&end_date=2025-03-31","description":"

Get all holidays within a date range. Maximum range is 1 year.

\n","urlObject":{"path":["holidays","indonesia","check","range"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Start date (YYYY-MM-DD)

\n","type":"text/plain"},"key":"start_date","value":"2025-01-01"},{"description":{"content":"

End date (YYYY-MM-DD)

\n","type":"text/plain"},"key":"end_date","value":"2025-03-31"}],"variable":[]}},"response":[],"_postman_id":"aba599ff-c7a7-42fe-b2a9-e1bd808fa696"},{"name":"Get Public Holidays in Date Range","id":"408ae012-2c24-47e1-93bb-c290206b782f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/check/range?start_date=2025-01-01&end_date=2025-12-31&type=Public Holiday","description":"

Get only public holidays within a date range.

\n","urlObject":{"path":["holidays","indonesia","check","range"],"host":["https://use.api.co.id"],"query":[{"key":"start_date","value":"2025-01-01"},{"key":"end_date","value":"2025-12-31"},{"description":{"content":"

Filter by holiday type

\n","type":"text/plain"},"key":"type","value":"Public Holiday"}],"variable":[]}},"response":[],"_postman_id":"408ae012-2c24-47e1-93bb-c290206b782f"}],"id":"c7b9ecd1-921b-406e-8b4e-684b7b6e5987","description":"

Endpoints for checking specific dates and date ranges.

\n","_postman_id":"c7b9ecd1-921b-406e-8b4e-684b7b6e5987"},{"name":"Upcoming & Next Holiday","item":[{"name":"Get Next Holiday (Any Type)","id":"bc1855bd-1762-4b39-8471-d19bf49f1743","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/next","description":"

Get the next upcoming holiday of any type from today, including countdown in days.

\n","urlObject":{"path":["holidays","indonesia","next"],"host":["https://use.api.co.id"],"query":[],"variable":[]}},"response":[{"id":"81c29e75-22e3-4641-a570-c1a108a319cf","name":"Success - Next Holiday with Countdown","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/next"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"holiday\": {\n \"id\": 1,\n \"date\": \"2025-01-01\",\n \"date_formatted\": \"1 Januari 2025\",\n \"day_of_week\": \"Rabu\",\n \"name\": \"Tahun Baru Masehi\",\n \"type\": \"Public Holiday\",\n \"year\": 2025,\n \"is_today\": false,\n \"is_upcoming\": true,\n \"days_until\": 44,\n \"is_holiday\": true,\n \"is_joint_holiday\": false,\n \"is_observance\": false\n },\n \"days_until\": 44,\n \"is_today\": false\n }\n}"}],"_postman_id":"bc1855bd-1762-4b39-8471-d19bf49f1743"},{"name":"Get Next Public Holiday","id":"5c1b0798-1933-4974-a4e9-824a66bbb250","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/next?type=Public Holiday","description":"

Get the next upcoming public holiday only.

\n","urlObject":{"path":["holidays","indonesia","next"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Filter by holiday type

\n","type":"text/plain"},"key":"type","value":"Public Holiday"}],"variable":[]}},"response":[],"_postman_id":"5c1b0798-1933-4974-a4e9-824a66bbb250"},{"name":"Get Upcoming Holidays (Default 10)","id":"2518dc8c-1432-484a-86e3-50536d4b6c9f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/upcoming","description":"

Get the next 10 upcoming holidays (default limit).

\n","urlObject":{"path":["holidays","indonesia","upcoming"],"host":["https://use.api.co.id"],"query":[],"variable":[]}},"response":[],"_postman_id":"2518dc8c-1432-484a-86e3-50536d4b6c9f"},{"name":"Get Upcoming Holidays (Custom Limit)","id":"7f7fa13a-77a9-451e-83a5-17396c88b62c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/upcoming?limit=5","description":"

Get a specific number of upcoming holidays.

\n","urlObject":{"path":["holidays","indonesia","upcoming"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Number of holidays to return (max: 100)

\n","type":"text/plain"},"key":"limit","value":"5"}],"variable":[]}},"response":[],"_postman_id":"7f7fa13a-77a9-451e-83a5-17396c88b62c"},{"name":"Get Upcoming Public Holidays Only","id":"ab31d425-4ffa-4bcb-9407-bdba13417751","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/upcoming?limit=10&type=Public Holiday","description":"

Get upcoming public holidays only with custom limit.

\n","urlObject":{"path":["holidays","indonesia","upcoming"],"host":["https://use.api.co.id"],"query":[{"key":"limit","value":"10"},{"key":"type","value":"Public Holiday"}],"variable":[]}},"response":[],"_postman_id":"ab31d425-4ffa-4bcb-9407-bdba13417751"}],"id":"9490bd26-da30-4fed-a3d5-2193910743dc","description":"

Endpoints for getting next and upcoming holidays with countdown.

\n","_postman_id":"9490bd26-da30-4fed-a3d5-2193910743dc"},{"name":"Statistics & Analytics","item":[{"name":"Get Holiday Statistics (Current Year)","id":"505a9bb9-8b06-4967-ac21-b3fe2bfcb943","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/stats","description":"

Get comprehensive statistics for the current year including:

\n\n","urlObject":{"path":["holidays","indonesia","stats"],"host":["https://use.api.co.id"],"query":[],"variable":[]}},"response":[{"id":"b5972981-7758-4de9-a77b-557925732f0b","name":"Success - 2025 Statistics","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":{"raw":"https://use.api.co.id/holidays/indonesia/stats?year=2025","host":["https://use.api.co.id"],"path":["holidays","indonesia","stats"],"query":[{"key":"year","value":"2025"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"year\": 2025,\n \"total_holidays\": 23,\n \"public_holidays\": 16,\n \"joint_holidays\": 3,\n \"national_holidays\": 2,\n \"observances\": 2,\n \"long_weekends\": 4,\n \"holidays_by_month\": {\n \"January\": 3,\n \"February\": 1,\n \"March\": 2,\n \"April\": 2,\n \"May\": 2,\n \"June\": 2,\n \"July\": 1,\n \"August\": 2,\n \"September\": 1,\n \"October\": 2,\n \"November\": 2,\n \"December\": 3\n },\n \"holidays_by_type\": {\n \"Public Holiday\": 16,\n \"Joint Holiday\": 3,\n \"National Holiday\": 2,\n \"Observance\": 2\n },\n \"upcoming_holidays\": [\n {\n \"id\": 1,\n \"date\": \"2025-01-01\",\n \"date_formatted\": \"1 Januari 2025\",\n \"day_of_week\": \"Rabu\",\n \"name\": \"Tahun Baru Masehi\",\n \"type\": \"Public Holiday\",\n \"year\": 2025,\n \"is_today\": false,\n \"is_upcoming\": true,\n \"days_until\": 44,\n \"is_holiday\": true,\n \"is_joint_holiday\": false,\n \"is_observance\": false\n }\n ],\n \"next_long_weekend\": {\n \"start_date\": \"2025-03-29\",\n \"end_date\": \"2025-03-31\",\n \"days\": 3,\n \"days_until\": 118,\n \"holidays\": [\n {\n \"id\": 5,\n \"date\": \"2025-03-29\",\n \"date_formatted\": \"29 Maret 2025\",\n \"day_of_week\": \"Sabtu\",\n \"name\": \"Hari Raya Nyepi\",\n \"type\": \"Public Holiday\",\n \"year\": 2025,\n \"is_today\": false,\n \"is_upcoming\": true,\n \"days_until\": 118,\n \"is_holiday\": true,\n \"is_joint_holiday\": false,\n \"is_observance\": false\n }\n ]\n }\n }\n}"}],"_postman_id":"505a9bb9-8b06-4967-ac21-b3fe2bfcb943"},{"name":"Get Holiday Statistics (Specific Year)","id":"955fbbce-ba90-466b-849e-84e45726406f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/stats?year=2025","description":"

Get comprehensive statistics for a specific year.

\n","urlObject":{"path":["holidays","indonesia","stats"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Year for statistics

\n","type":"text/plain"},"key":"year","value":"2025"}],"variable":[]}},"response":[],"_postman_id":"955fbbce-ba90-466b-849e-84e45726406f"},{"name":"Get Holiday Calendar (Full Year)","id":"867411a1-5d92-4569-9877-ea57eaca89e9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/calendar?year=2025","description":"

Get holidays organized by month for calendar display (all 12 months).

\n","urlObject":{"path":["holidays","indonesia","calendar"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Year for calendar view

\n","type":"text/plain"},"key":"year","value":"2025"}],"variable":[]}},"response":[],"_postman_id":"867411a1-5d92-4569-9877-ea57eaca89e9"},{"name":"Get Holiday Calendar (Specific Month)","id":"e501e037-e655-4154-bfa5-abc2a55d0812","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/calendar?year=2025&month=1","description":"

Get holidays for a specific month in calendar format.

\n","urlObject":{"path":["holidays","indonesia","calendar"],"host":["https://use.api.co.id"],"query":[{"key":"year","value":"2025"},{"description":{"content":"

Month (1-12)

\n","type":"text/plain"},"key":"month","value":"1"}],"variable":[]}},"response":[],"_postman_id":"e501e037-e655-4154-bfa5-abc2a55d0812"}],"id":"f721fad2-74a6-42e7-982b-ea09a983c01a","description":"

Endpoints for holiday statistics, analytics, and calendar views.

\n","_postman_id":"f721fad2-74a6-42e7-982b-ea09a983c01a"},{"name":"Metadata","item":[{"name":"Get Available Years","id":"7f71242f-3948-43c3-a123-e7d30dcfbbf5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/years","description":"

Get all years that have holiday data in the database.

\n","urlObject":{"path":["holidays","indonesia","years"],"host":["https://use.api.co.id"],"query":[],"variable":[]}},"response":[],"_postman_id":"7f71242f-3948-43c3-a123-e7d30dcfbbf5"},{"name":"Get Holiday Types","id":"5fdf4e78-69ef-408a-85d1-33b0a340e90d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/types","description":"

Get all available holiday types with descriptions:

\n\n","urlObject":{"path":["holidays","indonesia","types"],"host":["https://use.api.co.id"],"query":[],"variable":[]}},"response":[],"_postman_id":"5fdf4e78-69ef-408a-85d1-33b0a340e90d"}],"id":"96f24c69-a51b-4733-9f4c-7a3bd567f99b","description":"

Metadata endpoints for available years and holiday types.

\n","_postman_id":"96f24c69-a51b-4733-9f4c-7a3bd567f99b"},{"name":"Use Cases","item":[{"name":"UC1: Office Calendar Integration","id":"0ecdb4d3-37dc-47cb-b1ca-65075642935d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/?year=2025&type=Public Holiday&size=1000","description":"

Use Case 1: Get all public and joint holidays for office calendar.

\n","urlObject":{"path":["holidays","indonesia",""],"host":["https://use.api.co.id"],"query":[{"key":"year","value":"2025"},{"key":"type","value":"Public Holiday"},{"description":{"content":"

Get all holidays (no pagination)

\n","type":"text/plain"},"key":"size","value":"1000"}],"variable":[]}},"response":[],"_postman_id":"0ecdb4d3-37dc-47cb-b1ca-65075642935d"},{"name":"UC2: Leave Request Validation","id":"99731bab-0513-41e6-8f12-c30937ba977d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/check/date?date=2025-01-01","description":"

Use Case 2: Check if employee's leave request date is a holiday.

\n","urlObject":{"path":["holidays","indonesia","check","date"],"host":["https://use.api.co.id"],"query":[{"key":"date","value":"2025-01-01"}],"variable":[]}},"response":[],"_postman_id":"99731bab-0513-41e6-8f12-c30937ba977d"},{"name":"UC3: Shipping Date Calculator","id":"014ed52d-0cbe-4870-a0f8-a295906db38a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/check/range?start_date=2025-01-01&end_date=2025-01-31&type=Public Holiday","description":"

Use Case 3: Get all holidays in date range to calculate delivery dates.

\n","urlObject":{"path":["holidays","indonesia","check","range"],"host":["https://use.api.co.id"],"query":[{"key":"start_date","value":"2025-01-01"},{"key":"end_date","value":"2025-01-31"},{"key":"type","value":"Public Holiday"}],"variable":[]}},"response":[],"_postman_id":"014ed52d-0cbe-4870-a0f8-a295906db38a"},{"name":"UC4: Holiday Countdown Widget","id":"2dd8fbef-9060-4525-88f3-e8035e1dfc08","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/next?type=Public Holiday","description":"

Use Case 4: Show \"Next holiday in X days\" on dashboard.

\n","urlObject":{"path":["holidays","indonesia","next"],"host":["https://use.api.co.id"],"query":[{"key":"type","value":"Public Holiday"}],"variable":[]}},"response":[],"_postman_id":"2dd8fbef-9060-4525-88f3-e8035e1dfc08"},{"name":"UC5: Travel Planning (Long Weekends)","id":"adfb4cea-9cb6-4ec9-b974-3574530c61a2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/stats?year=2025","description":"

Use Case 5: Get holiday statistics including long weekend detection for vacation planning.

\n","urlObject":{"path":["holidays","indonesia","stats"],"host":["https://use.api.co.id"],"query":[{"key":"year","value":"2025"}],"variable":[]}},"response":[],"_postman_id":"adfb4cea-9cb6-4ec9-b974-3574530c61a2"},{"name":"UC6: Monthly Newsletter","id":"33678ee3-8dd8-4fb0-a2fc-c60c102ccbea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your_api_key_here","type":"text"}],"url":"https://use.api.co.id/holidays/indonesia/upcoming?limit=5","description":"

Use Case 6: Get next 5 upcoming holidays for company newsletter.

\n","urlObject":{"path":["holidays","indonesia","upcoming"],"host":["https://use.api.co.id"],"query":[{"key":"limit","value":"5"}],"variable":[]}},"response":[],"_postman_id":"33678ee3-8dd8-4fb0-a2fc-c60c102ccbea"}],"id":"cbc9b0c9-7197-42f0-a62c-1f701b063a0e","description":"

Real-world use case examples demonstrating practical API usage.

\n","_postman_id":"cbc9b0c9-7197-42f0-a62c-1f701b063a0e"}],"variable":[{"key":"base_url","value":"https://use.api.co.id","type":"string"},{"key":"api_key","value":"your_api_key_here","type":"string"}]}