{"openapi":"3.1.0","info":{"title":"Mardi Gras FYI API","version":"1.0.0","summary":"New Orleans (Orleans Parish) Carnival parade schedules, routes, krewes and local advice.","description":"Read-only, keyless public API. Dates and times are local to New Orleans (America/Chicago). A parade's time is when it departs the start of its route; it reaches any other block later. Each parade includes a citation URL on mardigras.fyi and a provenance block (null until source verification details are published). Please credit \"Mardi Gras FYI\" with a link when you show this data.","contact":{"name":"Mardi Gras FYI support","url":"https://mardigras.fyi/about#contact"}},"servers":[{"url":"https://mardigras.fyi/api/v1"}],"externalDocs":{"description":"Developer guide, examples and MCP connection","url":"https://mardigras.fyi/developers"},"paths":{"/score":{"get":{"operationId":"getCarnivalScore","summary":"Carnival Score for one place","description":"A 0 to 100 score (percentile across the city) for how much of Carnival is within walking distance of a corner, coordinates or a street address: parade routes weighted by size, and neighborhood traditions. Lists everything within an hour on foot with walking minutes and the nearest route corner or area. Based on 2026 routes until 2027 routes are confirmed.","parameters":[{"name":"street","in":"query","required":false,"description":"Street name; use with cross_street.","schema":{"type":"string"}},{"name":"cross_street","in":"query","required":false,"description":"Cross street.","schema":{"type":"string"}},{"name":"lat","in":"query","required":false,"description":"Latitude.","schema":{"type":"number"}},{"name":"lon","in":"query","required":false,"description":"Longitude.","schema":{"type":"number"}},{"name":"address","in":"query","required":false,"description":"Street address in Orleans Parish. Returns 503 until address points are loaded.","schema":{"type":"string"}},{"name":"dates","in":"query","required":false,"description":"Comma-separated YYYY-MM-DD dates in the 2027 season. Omit for the whole season.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/score/compare":{"get":{"operationId":"compareCarnivalScores","summary":"Compare two to six places","description":"Repeat at= for each place: \"29.93,-90.10\", \"Napoleon & St. Charles\", or an address.","parameters":[{"name":"at","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"minItems":2,"maxItems":6},"style":"form","explode":true},{"name":"dates","in":"query","required":false,"description":"Comma-separated YYYY-MM-DD dates in the 2027 season. Omit for the whole season.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/score/grid":{"get":{"operationId":"getCarnivalScoreGrid","summary":"Scored hex grid download","description":"Redirects to the static JSON grid: cell centers with season and per-day scores (default), or format=full for walking minutes per cell and parade.","parameters":[{"name":"format","in":"query","required":false,"description":"map (default) or full.","schema":{"type":"string","enum":["map","full"]}}],"responses":{"302":{"description":"Redirect to the grid file"}}}},"/traditions":{"get":{"operationId":"listTraditions","summary":"Neighborhood traditions","description":"Carnival groups that are not City-permitted float parades: walking clubs, bean krewes, Baby Dolls, Black Masking Indians, Super Sunday and more. Locations are only as precise as each group announces.","responses":{"200":{"description":"Every tradition","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","required":["slug","name","summary","mapType","sensitivity","where","when","facts","citation","sources"],"properties":{"category":{"enum":["walking","neighborhood","event"],"description":"walking: a walking parade with a public start, listed with the krewes. neighborhood: a masking tradition shown by neighborhood only. event: something you go to, not a group."},"slug":{"type":"string"},"name":{"type":"string"},"alsoKnownAs":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"},"mapType":{"enum":["route","area","meeting_point","none"]},"sensitivity":{"enum":["public","announced_only","no_location"],"description":"no_location: only a broad neighborhood is ever given; never a street, home or gathering place."},"where":{"type":"object","properties":{"note":{"type":"string"},"areas":{"type":"array","items":{"type":"object"}}}},"when":{"type":"array","items":{"type":"object","required":["day","usual"],"properties":{"day":{"type":"string"},"usual":{"type":"string"},"dateThisSeason":{"type":"string","format":"date"},"announced":{"type":"object"},"lastYear":{"type":"object"}}}},"facts":{"type":"array","items":{"type":"object","required":["text","status","verifiedAt","sources"],"properties":{"section":{"type":"string"},"text":{"type":"string"},"status":{"enum":["confirmed","tentative","unverified","conflict"]},"verifiedAt":{"type":"string","format":"date"},"sources":{"type":"array","items":{"type":"object","required":["name","url","publisher","kind","verifiedAt"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"string"},"kind":{"enum":["krewe","city","nopd","other_primary","secondary"]},"publishedAt":{"type":"string","format":"date"},"verifiedAt":{"type":"string","format":"date"}}}}}}},"etiquette":{"type":"array","items":{"type":"string"}},"citation":{"type":"object","required":["url","title"],"properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"}}},"sources":{"type":"array","items":{"type":"object","required":["name","url","publisher","kind","verifiedAt"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"string"},"kind":{"enum":["krewe","city","nopd","other_primary","secondary"]},"publishedAt":{"type":"string","format":"date"},"verifiedAt":{"type":"string","format":"date"}}}}}}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/traditions/{slug}":{"get":{"operationId":"getTradition","summary":"Get one neighborhood tradition","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","examples":["red-beans"]}}],"responses":{"200":{"description":"The tradition with sourced facts","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["slug","name","summary","mapType","sensitivity","where","when","facts","citation","sources"],"properties":{"category":{"enum":["walking","neighborhood","event"],"description":"walking: a walking parade with a public start, listed with the krewes. neighborhood: a masking tradition shown by neighborhood only. event: something you go to, not a group."},"slug":{"type":"string"},"name":{"type":"string"},"alsoKnownAs":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"},"mapType":{"enum":["route","area","meeting_point","none"]},"sensitivity":{"enum":["public","announced_only","no_location"],"description":"no_location: only a broad neighborhood is ever given; never a street, home or gathering place."},"where":{"type":"object","properties":{"note":{"type":"string"},"areas":{"type":"array","items":{"type":"object"}}}},"when":{"type":"array","items":{"type":"object","required":["day","usual"],"properties":{"day":{"type":"string"},"usual":{"type":"string"},"dateThisSeason":{"type":"string","format":"date"},"announced":{"type":"object"},"lastYear":{"type":"object"}}}},"facts":{"type":"array","items":{"type":"object","required":["text","status","verifiedAt","sources"],"properties":{"section":{"type":"string"},"text":{"type":"string"},"status":{"enum":["confirmed","tentative","unverified","conflict"]},"verifiedAt":{"type":"string","format":"date"},"sources":{"type":"array","items":{"type":"object","required":["name","url","publisher","kind","verifiedAt"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"string"},"kind":{"enum":["krewe","city","nopd","other_primary","secondary"]},"publishedAt":{"type":"string","format":"date"},"verifiedAt":{"type":"string","format":"date"}}}}}}},"etiquette":{"type":"array","items":{"type":"string"}},"citation":{"type":"object","required":["url","title"],"properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"}}},"sources":{"type":"array","items":{"type":"object","required":["name","url","publisher","kind","verifiedAt"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"string"},"kind":{"enum":["krewe","city","nopd","other_primary","secondary"]},"publishedAt":{"type":"string","format":"date"},"verifiedAt":{"type":"string","format":"date"}}}}}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/parades":{"get":{"operationId":"listParades","summary":"List parades","description":"Parades for a year, filtered by date, date range, period, area or name. Cancelled parades are excluded.","parameters":[{"name":"year","in":"query","required":false,"description":"Carnival year. Defaults to the upcoming season (2027 until Ash Wednesday 2027).","schema":{"type":"integer","minimum":1900,"maximum":2200,"examples":[2027]}},{"name":"date","in":"query","required":false,"description":"A single local date (YYYY-MM-DD); overrides start_date and end_date.","schema":{"type":"string","format":"date"}},{"name":"start_date","in":"query","required":false,"description":"First local date to include (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Last local date to include (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"period","in":"query","required":false,"description":"Named part of the season. The first weekend is Friday through Sunday; the second is Wednesday through Sunday.","schema":{"type":"string","enum":["season","first_weekend","second_weekend","mardi_gras_day"]}},{"name":"area","in":"query","required":false,"description":"Parade area, for example Uptown or Mid-City.","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Case-insensitive match on parade or krewe name.","schema":{"type":"string"}}],"responses":{"200":{"description":"Parades in schedule order","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Parade"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/parades/{event_id}":{"get":{"operationId":"getParade","summary":"Get one parade","parameters":[{"name":"event_id","in":"path","required":true,"description":"Stable event identifier from the parade list, for example event:rex:2027-02-09.","schema":{"type":"string","examples":["event:rex:2027-02-09"]}}],"responses":{"200":{"description":"The parade, with its profile and local notes when available","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ParadeDetail"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/parades/{event_id}/route":{"get":{"operationId":"getParadeRoute","summary":"Get a parade route as GeoJSON","description":"A GeoJSON Feature with MultiLineString geometry in WGS84. geometry is null when no reviewed route map is available.","parameters":[{"name":"event_id","in":"path","required":true,"description":"Stable event identifier from the parade list, for example event:rex:2027-02-09.","schema":{"type":"string","examples":["event:rex:2027-02-09"]}}],"responses":{"200":{"description":"Route feature","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/RouteFeature"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/parades/nearby":{"get":{"operationId":"findNearbyParades","summary":"Parades near a point within a time window","description":"Parades whose mapped route passes within radius_meters of the point, grouped by whether they depart within the window. Distances are straight-line to the route. Departure times are not arrival times at the point.","parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude (WGS84).","schema":{"type":"number","minimum":-90,"maximum":90}},{"name":"lon","in":"query","required":true,"description":"Longitude (WGS84).","schema":{"type":"number","minimum":-180,"maximum":180}},{"name":"radius_meters","in":"query","required":false,"description":"Search radius from the point to the route.","schema":{"type":"integer","minimum":50,"maximum":3000,"default":800}},{"name":"from","in":"query","required":false,"description":"Window start. YYYY-MM-DDTHH:MM (or a bare YYYY-MM-DD, meaning midnight) is New Orleans local time; a value with Z or an offset is an instant. Defaults to now.","schema":{"type":"string","examples":["2027-02-05T17:00"]}},{"name":"within_hours","in":"query","required":false,"description":"Window length in hours.","schema":{"type":"number","minimum":0.5,"maximum":12,"default":2}}],"responses":{"200":{"description":"Nearby parades by departure timing","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/NearbyResult"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/streets/parades":{"get":{"operationId":"findParadesOnStreet","summary":"Parades on a street or through an intersection","description":"Matches City of New Orleans road centerlines to mapped routes. Without cross_street, returns parades running along the street (along) and those that only cross or touch it (crosses). With cross_street, returns parades passing that corner (passes); if the names meet at more than one corner the response is 409 with the candidate corners. Parades without a route map are listed in unmapped: it is unknown whether they use the street.","parameters":[{"name":"year","in":"query","required":false,"description":"Carnival year. Defaults to the upcoming season (2027 until Ash Wednesday 2027).","schema":{"type":"integer","minimum":1900,"maximum":2200,"examples":[2027]}},{"name":"street","in":"query","required":true,"description":"Street name, for example \"St. Charles Avenue\" or \"Napoleon\".","schema":{"type":"string"}},{"name":"cross_street","in":"query","required":false,"description":"Cross street, for an intersection lookup.","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"First local date to include (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Last local date to include (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"period","in":"query","required":false,"description":"Named part of the season. The first weekend is Friday through Sunday; the second is Wednesday through Sunday.","schema":{"type":"string","enum":["season","first_weekend","second_weekend","mardi_gras_day"]}}],"responses":{"200":{"description":"Parades on the street","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/StreetResult"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"The street names meet at more than one corner; error.details.candidates lists each with full street names","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/krewes":{"get":{"operationId":"listKrewes","summary":"List krewes and parade names","responses":{"200":{"description":"Krewes","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"href":{"type":"string"}}}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/krewes/{name}":{"get":{"operationId":"getKrewe","summary":"Get a krewe","description":"Krewe profile, sourced parade notes, City permit figures with their year, and parades by year.","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","examples":["endymion"]}}],"responses":{"200":{"description":"Krewe","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Krewe"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/seasons/{year}":{"get":{"operationId":"getSeason","summary":"Carnival season dates","description":"Carnival start (January 6), the two main parade weekends and Mardi Gras day, computed from Gregorian Easter.","parameters":[{"name":"year","in":"path","required":true,"schema":{"type":"integer","minimum":1900,"maximum":2200}}],"responses":{"200":{"description":"Season dates","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Season"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/guide":{"get":{"operationId":"searchGuide","summary":"Search local advice","description":"Practical advice on watching with kids, arrival, restrooms, rideshares, crossing routes, throws, weather and parade trackers. An empty query returns every article.","parameters":[{"name":"query","in":"query","required":false,"description":"Search words, for example \"bathrooms\" or \"parking\".","schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"Matching articles","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GuideArticle"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/throws":{"get":{"operationId":"listThrows","summary":"List signature Mardi Gras throws","description":"Each krewe’s signature throw (or notable throws), with sources and, where a free image exists, its credit and license.","parameters":[{"name":"krewe","in":"query","description":"Krewe slug, for example zulu or muses.","schema":{"type":"string"}},{"name":"kind","in":"query","description":"signature, notable or historic.","schema":{"type":"string","enum":["signature","notable","historic"]}},{"name":"has_image","in":"query","description":"true for throws with a picture.","schema":{"type":"string","enum":["true","false"]}}],"responses":{"200":{"description":"Throws","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","krewe","name","kind","summary","sources","verifiedAt"],"properties":{"id":{"type":"string","examples":["zulu-coconut"]},"krewe":{"type":"string"},"kreweName":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["signature","notable","historic"]},"summary":{"type":"string"},"details":{"type":"array","items":{"type":"string"}},"material":{"type":["string","null"]},"maker":{"type":["string","null"]},"since":{"type":["object","null"]},"check":{"type":"string","enum":["confirmed","reported","unconfirmed"]},"sources":{"type":"array","items":{"type":"object"}},"verifiedAt":{"type":"string","format":"date"},"contributor":{"type":"string"},"url":{"type":"string"},"kreweUrl":{"type":["string","null"]},"image":{"type":["object","null"],"properties":{"url":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"alt":{"type":"string"},"caption":{"type":"string"},"credit":{"type":"string"},"license":{"type":"string"},"licenseUrl":{"type":"string"},"sourceUrl":{"type":"string"},"rights":{"type":"string","enum":["free-license","public-domain"]},"shareAlike":{"type":"boolean"},"licenseCheckedAt":{"type":"string","format":"date"}}}}}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/throws/{id}":{"get":{"operationId":"getThrow","summary":"Get one throw","parameters":[{"name":"id","in":"path","required":true,"description":"Throw id, for example muses-shoe.","schema":{"type":"string"}}],"responses":{"200":{"description":"The throw","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["id","krewe","name","kind","summary","sources","verifiedAt"],"properties":{"id":{"type":"string","examples":["zulu-coconut"]},"krewe":{"type":"string"},"kreweName":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["signature","notable","historic"]},"summary":{"type":"string"},"details":{"type":"array","items":{"type":"string"}},"material":{"type":["string","null"]},"maker":{"type":["string","null"]},"since":{"type":["object","null"]},"check":{"type":"string","enum":["confirmed","reported","unconfirmed"]},"sources":{"type":"array","items":{"type":"object"}},"verifiedAt":{"type":"string","format":"date"},"contributor":{"type":"string"},"url":{"type":"string"},"kreweUrl":{"type":["string","null"]},"image":{"type":["object","null"],"properties":{"url":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"alt":{"type":"string"},"caption":{"type":"string"},"credit":{"type":"string"},"license":{"type":"string"},"licenseUrl":{"type":"string"},"sourceUrl":{"type":"string"},"rights":{"type":"string","enum":["free-license","public-domain"]},"shareAlike":{"type":"boolean"},"licenseCheckedAt":{"type":"string","format":"date"}}}}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}}},"components":{"schemas":{"LocalNote":{"type":"object","required":["text","confidence","sources"],"properties":{"text":{"type":"string"},"confidence":{"enum":["high","medium","low"]},"sources":{"type":"array","items":{"type":"object","required":["name","url","publisher"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"string"}}}}}},"LocalKnowledge":{"type":"object","description":"What watching this parade is like, written from published sources. review is research until a local has read it.","required":["verifiedAt","review","crowd","vibe","arrival","spotSaving","bestSpots","stallPoints","painPoints","signatureThrows","familyFit","afterward"],"properties":{"verifiedAt":{"type":"string","format":"date"},"review":{"enum":["research","local"]},"crowd":{"allOf":[{"$ref":"#/components/schemas/LocalNote"},{"type":"object","properties":{"level":{"enum":["light","moderate","heavy","very-heavy"]}}}]},"vibe":{"$ref":"#/components/schemas/LocalNote"},"arrival":{"allOf":[{"$ref":"#/components/schemas/LocalNote"},{"type":"object","properties":{"pattern":{"type":"object","required":["kind"],"properties":{"kind":{"enum":["walk-up","hours-before","morning-of","day-before"]},"hours":{"type":"number"}}}}}]},"spotSaving":{"$ref":"#/components/schemas/LocalNote"},"bestSpots":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/LocalNote"},{"type":"object","properties":{"where":{"type":"string"}}}]}},"stallPoints":{"type":"array","items":{"$ref":"#/components/schemas/LocalNote"}},"painPoints":{"type":"array","items":{"$ref":"#/components/schemas/LocalNote"}},"signatureThrows":{"type":"array","items":{"$ref":"#/components/schemas/LocalNote"}},"familyFit":{"allOf":[{"$ref":"#/components/schemas/LocalNote"},{"type":"object","properties":{"rating":{"enum":["great","good","mixed","adults"]}}}]},"afterward":{"$ref":"#/components/schemas/LocalNote"}}},"ParadeDetail":{"allOf":[{"$ref":"#/components/schemas/Parade"},{"type":"object","properties":{"local":{"allOf":[{"$ref":"#/components/schemas/LocalKnowledge"}],"description":"Local notes for this parade. Present only for 2027 and later parades that have a profile."}}}]},"Meta":{"type":"object","required":["apiVersion","attribution","timezone","generatedAt"],"properties":{"apiVersion":{"const":"1"},"attribution":{"type":"string"},"timezone":{"const":"America/Chicago"},"generatedAt":{"type":"string","format":"date-time"},"timingNote":{"type":"string"},"count":{"type":"integer"}},"additionalProperties":true},"Citation":{"type":"object","required":["url","title"],"properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"}}},"SourceRef":{"type":"object","required":["sourceUrl","publisher","sourceKind","verifiedAt","observedYear"],"properties":{"sourceUrl":{"type":"string","format":"uri"},"publisher":{"type":"string"},"sourceKind":{"enum":["krewe","city","nopd","other_primary","secondary"]},"verifiedAt":{"type":"string","format":"date"},"observedYear":{"type":["integer","null"]},"publishedAt":{"type":"string","format":"date","description":"The source's own publication or presentation date, when known (e.g. 2026-07-22 for the NOPD deck). Omitted when unknown; verifiedAt is when we last checked it."}}},"FieldProvenance":{"type":"object","required":["status","source","corroboratedBy","conflictsWith"],"properties":{"status":{"enum":["confirmed","tentative","conflict","unverified"]},"source":{"oneOf":[{"$ref":"#/components/schemas/SourceRef"},{"type":"null"}]},"corroboratedBy":{"type":"array","items":{"$ref":"#/components/schemas/SourceRef"}},"conflictsWith":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/SourceRef"},{"type":"object","properties":{"value":{"type":["string","null"]},"basis":{"enum":["announced","proposed"],"description":"Whether the conflicting source announced the value or only proposed it."}}}]}},"proposedBy":{"type":"array","items":{"$ref":"#/components/schemas/SourceRef"},"description":"Primary sources that only proposed this same value for this year (e.g. NOPD to a Council committee). Shown for context; a proposal never raises the status. Empty when none."}}},"Provenance":{"type":["object","null"],"description":"Source and verification details. confirmed: a primary source plus a different publisher agree; tentative: one primary source for this year; unverified: no current-year primary source; conflict: sources disagree. Null until published for this record.","properties":{"status":{"enum":["confirmed","tentative","conflict","unverified"],"description":"Whole record: date, time and any route. Use it to decide whether to rely on the record without caveats."},"scheduleStatus":{"enum":["confirmed","tentative","conflict","unverified"],"description":"Date and any announced start time only (a relative start counts; the route never lowers it). Use it to label when a parade is."},"verifiedAt":{"type":["string","null"],"format":"date"},"fields":{"type":"object","description":"eventStatus appears only when a dated status check exists (cancellations or disputed status); its conflicting values are scheduled or cancelled.","properties":{"date":{"$ref":"#/components/schemas/FieldProvenance"},"time":{"$ref":"#/components/schemas/FieldProvenance"},"route":{"$ref":"#/components/schemas/FieldProvenance"},"floatCount":{"$ref":"#/components/schemas/FieldProvenance"},"eventStatus":{"$ref":"#/components/schemas/FieldProvenance"}}}}},"Parade":{"type":"object","required":["id","name","year","date","time","timeLabel","timezone","area","routeAvailable","citation","provenance"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"year":{"type":"integer"},"date":{"type":"string","format":"date"},"weekday":{"type":"string","description":"Day of the week for date, for example Friday."},"time":{"type":["string","null"],"description":"Local departure time HH:MM:SS, or null for a relative or unannounced start."},"timeLabel":{"type":"string","description":"Display time, such as 6:00 PM or Follows Hermes."},"timezone":{"const":"America/Chicago"},"area":{"type":"string"},"routeAvailable":{"type":"boolean"},"routeYear":{"type":["integer","null"],"description":"Season the route map comes from; earlier than year means last season's route, not this year's. Null without a map or when the source gives no year."},"floatCount":{"type":["integer","null"]},"format":{"enum":["floats","trucks","walking","streetcar"],"description":"How the parade rolls: tractor-pulled floats, decorated trucks, on foot, or on a streetcar."},"details":{"type":"object"},"citation":{"$ref":"#/components/schemas/Citation"},"provenance":{"$ref":"#/components/schemas/Provenance"},"expected":{"oneOf":[{"$ref":"#/components/schemas/ExpectedTime"},{"type":"null"}],"description":"Display-only expected start time from the prior year, when this year's time has no current-year primary source. Never evidence; see docs/PROVENANCE.md for the wording rules."}}},"ExpectedTime":{"type":"object","required":["time","label","basis","fromYear","source","matchesListed"],"properties":{"time":{"type":"string","description":"HH:MM:SS, or follows for a relative start."},"label":{"type":"string","description":"Display time from the prior year, such as 6:15 PM or Follows Rex."},"basis":{"const":"prior_year"},"fromYear":{"type":"integer"},"source":{"$ref":"#/components/schemas/SourceRef"},"matchesListed":{"type":["boolean","null"],"description":"Whether it equals the listed time; null when no time is listed."}}},"RouteFeature":{"type":"object","properties":{"type":{"const":"Feature"},"geometry":{"type":["object","null"],"properties":{"type":{"const":"MultiLineString"},"coordinates":{"type":"array"}}},"properties":{"type":"object","properties":{"event_id":{"type":"string"},"name":{"type":"string"},"formation":{"type":["string","null"]},"disband":{"type":["string","null"]},"routeAvailable":{"type":"boolean"},"routeYear":{"type":["integer","null"],"description":"Season the route map comes from."},"routeImage":{"type":["object","null"],"description":"A drawn map of the route (SVG), full size and phone size, with a caption naming the season the route comes from.","properties":{"url":{"type":"string"},"phoneUrl":{"type":"string"},"format":{"const":"image/svg+xml"},"caption":{"type":"string"}}},"streets":{"type":"array","description":"Streets the route runs along, matched to City centerlines, in travel order when streetOrder is from_formation or to_disband.","items":{"type":"object","properties":{"street":{"type":"string"},"meters":{"type":"integer"}}}},"streetOrder":{"enum":["from_formation","to_disband","map_order",null]}}}}},"ParadeAt":{"allOf":[{"$ref":"#/components/schemas/Parade"},{"type":"object","properties":{"formation":{"type":["string","null"],"description":"Where the route forms, when known."},"disband":{"type":["string","null"],"description":"Where the route disbands, when known."},"distanceMeters":{"type":"integer"},"alongMeters":{"type":"integer"},"minutesUntilDeparture":{"type":"integer"},"minutesSinceDeparture":{"type":"integer"},"follows":{"type":["string","null"]},"reason":{"type":"string"}}}]},"StreetResult":{"type":"object","properties":{"status":{"const":"ok"},"year":{"type":"integer"},"street":{"type":"object","properties":{"query":{"type":"string"},"names":{"type":"array","items":{"type":"string"}}}},"cross_street":{"type":["object","null"]},"intersection":{"type":["object","null"],"properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}}},"passes":{"type":"array","items":{"$ref":"#/components/schemas/ParadeAt"}},"along":{"type":"array","items":{"$ref":"#/components/schemas/ParadeAt"}},"crosses":{"type":"array","items":{"$ref":"#/components/schemas/ParadeAt"}},"unmapped":{"type":"array","items":{"$ref":"#/components/schemas/ParadeAt"}},"priorYear":{"type":["object","null"],"description":"Street lookups only: parades that ran along the street the previous season but not on this season’s route.","properties":{"year":{"type":"integer"},"notAlongThisYear":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/ParadeAt"},{"type":"object","properties":{"thisYear":{"enum":["route_changed","route_unmapped","not_on_calendar"]},"routeProvenance":{}}}]}}}}}},"NearbyResult":{"type":"object","properties":{"from":{"type":"object"},"until":{"type":"object"},"radiusMeters":{"type":"integer"},"departingInWindow":{"type":"array","items":{"$ref":"#/components/schemas/ParadeAt"}},"departedEarlier":{"type":"array","items":{"$ref":"#/components/schemas/ParadeAt"}},"relativeStarts":{"type":"array","items":{"$ref":"#/components/schemas/ParadeAt"}},"unannounced":{"type":"array","items":{"$ref":"#/components/schemas/ParadeAt"}},"unmapped":{"type":"array","items":{"$ref":"#/components/schemas/ParadeAt"}},"distanceType":{"const":"straight_line_to_route"}}},"Krewe":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"summary":{"type":["string","null"]},"highlights":{"type":"array","items":{"type":"string"}},"editions":{"type":"array"},"permits":{"type":"array"},"permitsNote":{"type":["string","null"],"description":"How to read City permit figures."},"guideAnswers":{"type":"array","description":"Sourced guide answers about this krewe.","items":{"type":"object","properties":{"article":{"type":"string"},"id":{"type":"string"},"question":{"type":"string"},"answer":{"type":"string"},"sources":{"type":"array"}}}},"sources":{"type":"array"},"parades":{"type":"array","items":{"$ref":"#/components/schemas/Parade"}}}},"Season":{"type":"object","properties":{"year":{"type":"integer"},"timezone":{"type":"string"},"start":{"type":"string","format":"date"},"mardiGras":{"type":"string","format":"date"},"firstWeekend":{"type":"object"},"secondWeekend":{"type":"object"}}},"GuideArticle":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","docs"],"properties":{"code":{"enum":["invalid_parameter","not_found","street_not_found","ambiguous_intersection","method_not_allowed","rate_limited","service_unavailable"]},"message":{"type":"string"},"details":{},"docs":{"type":"string","format":"uri"}}}}}},"responses":{"BadRequest":{"description":"Invalid parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Unknown parade, krewe, street or path","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Too many requests; retry after the Retry-After seconds","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unavailable":{"description":"Temporary failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}