{
  "openapi": "3.0.3",
  "info": {
    "title": "India Holidays API",
    "version": "1.0.0",
    "description": "Free, fast, reliable REST API providing Indian holiday datasets across 36 States and Union Territories with long weekend planning, iCalendar feeds, and business day calculations.",
    "license": {
      "name": "MIT",
      "url": "https://opensource.org/licenses/MIT"
    }
  },
  "servers": [
    {
      "url": "https://holiday2api.vercel.app",
      "description": "Production Edge CDN"
    }
  ],
  "paths": {
    "/api/holidays/{year}": {
      "get": {
        "summary": "Get all holidays for a year",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "example": "2026"
            }
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "TG"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "national"
            }
          },
          {
            "name": "month",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "08"
            }
          },
          {
            "name": "date",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "2026-01-26"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Holiday list"
          }
        }
      }
    },
    "/api/holidays/{year}/{state}": {
      "get": {
        "summary": "Get holidays for a specific state",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "example": "2026"
            }
          },
          {
            "name": "state",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "example": "MH"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "month",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "date",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "State holiday list"
          }
        }
      }
    },
    "/api/holidays": {
      "get": {
        "summary": "Dynamic holiday query filter",
        "parameters": [
          {
            "name": "year",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "2026"
            }
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "IN"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "month",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "date",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Filtered holiday list"
          }
        }
      }
    },
    "/api/holidays/upcoming": {
      "get": {
        "summary": "Get upcoming holidays from today",
        "parameters": [
          {
            "name": "state",
            "in": "query",
            "schema": {
              "type": "string",
              "example": "IN"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 10
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Upcoming holidays list"
          }
        }
      }
    },
    "/api/long-weekends/{year}/{state}": {
      "get": {
        "summary": "Get long weekends and bridge leave planner",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "example": "2026"
            }
          },
          {
            "name": "state",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "example": "KA"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Long weekend recommendations"
          }
        }
      }
    },
    "/api/business-days": {
      "get": {
        "summary": "Calculate working and business days",
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "example": "2026-03-01"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "example": "2026-03-31"
            }
          },
          {
            "name": "state",
            "in": "query",
            "schema": {
              "type": "string",
              "example": "MH"
            }
          },
          {
            "name": "bank_rules",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Working days calculation breakdown"
          }
        }
      }
    },
    "/api/calendar/{year}/{state}.ics": {
      "get": {
        "summary": "Download RFC 5545 iCalendar feed",
        "parameters": [
          {
            "name": "year",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "example": "2026"
            }
          },
          {
            "name": "state",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "example": "DL"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "iCalendar text feed"
          }
        }
      }
    },
    "/api/meta/states": {
      "get": {
        "summary": "List all supported states and UTs",
        "responses": {
          "200": {
            "description": "States list"
          }
        }
      }
    },
    "/api/meta/types": {
      "get": {
        "summary": "List holiday classifications",
        "responses": {
          "200": {
            "description": "Types list"
          }
        }
      }
    },
    "/api/health": {
      "get": {
        "summary": "API health check",
        "responses": {
          "200": {
            "description": "Health status"
          }
        }
      }
    }
  }
}