{"openapi":"3.1.0","info":{"title":"Stallday API","version":"1.0.0","description":"Trading sessions, markets and traders for UK mobile vendors — street food first. Every fact carries a source and an observation date.","contact":{"name":"Stallday data partnerships","url":"https://www.stallday.co.uk/for-developers"},"license":{"name":"Attribution required","url":"https://www.stallday.co.uk/data/licence"}},"servers":[{"url":"https://www.stallday.co.uk/api/v1"}],"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"An API key, issued at https://www.stallday.co.uk/for-developers. Also accepted as an X-Api-Key header."}}},"security":[{"apiKey":[]}],"paths":{"/trading_sessions":{"get":{"summary":"Which traders work which markets, on which days","operationId":"listTradingSessions","parameters":[{"name":"date","in":"query","required":false,"description":"Single ISO date","schema":{"type":"date"}},{"name":"from","in":"query","required":false,"description":"Window start","schema":{"type":"date"}},{"name":"to","in":"query","required":false,"description":"Window end","schema":{"type":"date"}},{"name":"market","in":"query","required":false,"description":"Market slug or id","schema":{"type":"string"}},{"name":"vendor","in":"query","required":false,"description":"Vendor slug or id","schema":{"type":"string"}},{"name":"cuisine","in":"query","required":false,"description":"Cuisine key","schema":{"type":"string"}},{"name":"dietary","in":"query","required":false,"description":"Comma-separated dietary tags","schema":{"type":"string"}},{"name":"per_page","in":"query","required":false,"description":"1..200","schema":{"type":"integer"}}],"responses":{"200":{"description":"Trading sessions with provenance"}}}},"/trading_sessions/today":{"get":{"summary":"Today's sessions","operationId":"todaysSessions","responses":{"200":{"description":"OK"}}}},"/trading_sessions/this_weekend":{"get":{"summary":"This weekend's sessions","operationId":"weekendSessions","responses":{"200":{"description":"OK"}}}},"/markets":{"get":{"summary":"List markets","operationId":"listMarkets","parameters":[{"name":"area","in":"query","required":false,"description":"Area slug","schema":{"type":"string"}},{"name":"open_today","in":"query","required":false,"description":"Trading today","schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK"}}}},"/markets/{id}":{"get":{"summary":"One market","operationId":"getMarket","parameters":[{"name":"id","in":"path","required":true,"description":"Slug or id","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/markets/{id}/roster":{"get":{"summary":"Trader roster for one market on one date","operationId":"getMarketRoster","parameters":[{"name":"id","in":"path","required":true,"description":"Slug or id","schema":{"type":"string"}},{"name":"date","in":"query","required":false,"description":"ISO date","schema":{"type":"date"}}],"responses":{"200":{"description":"OK"}}}},"/vendors":{"get":{"summary":"List traders","operationId":"listVendors","responses":{"200":{"description":"OK"}}}}}}