{"note":"OpenAPI conversion -- returning structured metadata","name":"canada-holidays-ca","description":"Canada Holidays API","version":"1.8.0","base_url":"https://canada-holidays.ca","endpoints":6,"raw":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Canada Holidays API\n@base https://canada-holidays.ca\n@version 1.8.0\n@endpoints 6\n@toc api(6)\n\n@endpoint GET /api/v1\n@desc root\n@returns(200) {message: str, _links: map{self: map{href: str}, holidays: map{href: str}, provinces: map{href: str}, spec: map{href: str}}} # OK\n\n@endpoint GET /api/v1/holidays\n@desc Get all holidays\n@optional {year: int=2023 # A calendar year, federal: str(1/0/true/false) # A boolean parameter. If true or 1, will return only federal holidays. If false or 0, will return no federal holidays., optional: str(1/0/true/false)=false # A boolean parameter. If false or 0 (default), will return only legislated holidays. If true or 1, will return optional holidays from Alberta and BC.}\n@returns(200) {holidays: [map]} # OK\n\n@endpoint GET /api/v1/provinces\n@desc Get all provinces\n@optional {year: int=2023 # A calendar year, optional: str(1/0/true/false)=false # A boolean parameter. If false or 0 (default), will return only legislated holidays. If true or 1, will return optional holidays from Alberta and BC.}\n@returns(200) {provinces: [map]} # OK\n\n@endpoint GET /api/v1/provinces/{provinceId}\n@desc Get a province or territory by abbreviation\n@optional {year: int=2023 # A calendar year, optional: str(1/0/true/false)=false # A boolean parameter (AB and BC only). If false or 0 (default), will return only legislated holidays. If true or 1, will return optional holidays from Alberta and BC.}\n@returns(200) {province: map{id: str, nextHoliday: map{id: int, date: str(date), nameEn: str, nameFr: str, federal: int(binary), observedDate: str(date), provinces: [map], optional: int(binary)}, provinces: [map], nameFr: str, nameEn: str, sourceLink: str(uri), sourceEn: str, optional: int(binary)}} # OK\n@errors {400: Bad Request}\n\n@endpoint GET /api/v1/holidays/{holidayId}\n@desc Get a holiday by id\n@optional {year: int=2023 # A calendar year, optional: str(1/0/true/false)=false # A boolean parameter. If false or 0 (default), will return provinces for which this is a legislated holiday. If true or 1, will return provinces which optionally celebrate this holiday.}\n@returns(200) {holiday: map{id: int, date: str(date), nameEn: str, nameFr: str, federal: int(binary), observedDate: str(date), provinces: [map], optional: int(binary)}} # OK\n@errors {400: Bad Request}\n\n@endpoint GET /api/v1/spec\n@desc Get JSON schema\n@returns(200) OK\n\n@end\n"}