{"openapi":"3.1.0","info":{"title":"listen.no API","version":"1.0.0","description":"Read-only API for upcoming art exhibitions and events in Norway, as listed on listen.no. No authentication. Responses are cached for five minutes."},"servers":[{"url":"https://www.listen.no/api/v1"}],"externalDocs":{"url":"https://www.listen.no/agents"},"paths":{"/events":{"get":{"operationId":"listEvents","summary":"Upcoming events, optionally filtered","parameters":[{"name":"query","in":"query","schema":{"type":"string"},"description":"Free text: artist, title, venue"},{"name":"city","in":"query","schema":{"type":"string"}},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"Running on or after this date (default today)"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"Starting on or before this date"},{"name":"tag","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"Events","content":{"application/json":{"schema":{"type":"object","properties":{"events":{"type":"array","items":{"$ref":"#/components/schemas/Event"}}}}}}},"400":{"description":"Invalid date"}}}},"/events/{slug}":{"get":{"operationId":"getEvent","summary":"One event with description, links and images","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Event","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventDetail"}}}},"404":{"description":"Not found"}}}},"/venues":{"get":{"operationId":"listVenues","summary":"All venues","parameters":[{"name":"city","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Venues","content":{"application/json":{"schema":{"type":"object","properties":{"venues":{"type":"array","items":{"$ref":"#/components/schemas/VenueRef"}}}}}}}}}},"/venues/{slug}":{"get":{"operationId":"getVenue","summary":"One venue with upcoming events","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Venue","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Venue"}}}},"404":{"description":"Not found"}}}},"/cities":{"get":{"operationId":"listCities","summary":"Cities with upcoming events","responses":{"200":{"description":"Cities","content":{"application/json":{"schema":{"type":"object","properties":{"cities":{"type":"array","items":{"type":"string"}}}}}}}}}},"/health":{"get":{"operationId":"health","summary":"Health check","responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"VenueRef":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"streetAddress":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"city":{"type":["string","null"]}}},"Event":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"startDate":{"type":["string","null"],"format":"date"},"endDate":{"type":["string","null"],"format":"date"},"permanent":{"type":"boolean"},"tags":{"type":"array","items":{"type":"string"}},"venue":{"oneOf":[{"$ref":"#/components/schemas/VenueRef"},{"type":"null"}]}}},"EventDetail":{"allOf":[{"$ref":"#/components/schemas/Event"},{"type":"object","properties":{"description":{"type":"string","description":"Markdown"},"links":{"type":"array","items":{"type":"string","format":"uri"}},"images":{"type":"array","items":{"type":"string","format":"uri"}}}}]},"Venue":{"allOf":[{"$ref":"#/components/schemas/VenueRef"},{"type":"object","properties":{"description":{"type":"string","description":"Markdown"},"links":{"type":"array","items":{"type":"string","format":"uri"}},"upcomingEvents":{"type":"array","items":{"$ref":"#/components/schemas/Event"}}}}]}}}}