{"openapi":"3.1.0","info":{"title":"BLUPRNT Public API","version":"1.0.0","description":"Read-only access to BLUPRNT's live catalogue of Miami nightlife: upcoming events, venues, artists and cities. No key required. Responses are cached for five minutes. An MCP server with the same data is at https://bluprnt.peopleplacesthingsmiami.com/api/mcp.","contact":{"name":"PeoplePlacesThingsMiami","url":"https://www.peopleplacesthingsmiami.com","email":"support@peopleplacesthingsmiami.com"}},"servers":[{"url":"https://bluprnt.peopleplacesthingsmiami.com"}],"paths":{"/api/public/events":{"get":{"operationId":"searchEvents","summary":"Search upcoming events","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Free text over name, venue, lineup, genre, neighborhood, description"},{"name":"city","in":"query","schema":{"type":"string","default":"miami"}},{"name":"date","in":"query","schema":{"type":"string"},"description":"today | tomorrow | weekend | YYYY-MM-DD"},{"name":"from","in":"query","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","schema":{"type":"string","format":"date"}},{"name":"neighborhood","in":"query","schema":{"type":"string"}},{"name":"genre","in":"query","schema":{"type":"string"}},{"name":"free","in":"query","schema":{"type":"boolean"}},{"name":"live","in":"query","schema":{"type":"boolean"},"description":"Happening right now"},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":200}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Events sorted by start time","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"count":{"type":"integer"},"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Slug used in the event URL"},"url":{"type":"string","format":"uri"},"name":{"type":"string"},"date":{"type":"string","format":"date"},"startTime":{"type":["string","null"]},"endTime":{"type":["string","null"]},"startsAt":{"type":["string","null"],"format":"date-time"},"endsAt":{"type":["string","null"],"format":"date-time"},"live":{"type":"boolean"},"city":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"timezone":{"type":"string"}}},"venue":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string"},"address":{"type":["string","null"]},"neighborhood":{"type":["string","null"]},"lat":{"type":["number","null"]},"lng":{"type":["number","null"]},"type":{"type":["string","null"]}}},"price":{"type":"object","properties":{"label":{"type":["string","null"]},"kind":{"type":"string","enum":["free","paid","unknown"]}}},"genres":{"type":"array","items":{"type":"string"}},"category":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"ageRange":{"type":["string","null"]},"lineup":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]},"image":{"type":["string","null"],"format":"uri"},"ticketsUrl":{"type":["string","null"],"format":"uri"}}}}}}}}}}}},"/api/public/events/{id}":{"get":{"operationId":"getEvent","summary":"One event by id","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The event","content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"object","properties":{"id":{"type":"string","description":"Slug used in the event URL"},"url":{"type":"string","format":"uri"},"name":{"type":"string"},"date":{"type":"string","format":"date"},"startTime":{"type":["string","null"]},"endTime":{"type":["string","null"]},"startsAt":{"type":["string","null"],"format":"date-time"},"endsAt":{"type":["string","null"],"format":"date-time"},"live":{"type":"boolean"},"city":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"timezone":{"type":"string"}}},"venue":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string"},"address":{"type":["string","null"]},"neighborhood":{"type":["string","null"]},"lat":{"type":["number","null"]},"lng":{"type":["number","null"]},"type":{"type":["string","null"]}}},"price":{"type":"object","properties":{"label":{"type":["string","null"]},"kind":{"type":"string","enum":["free","paid","unknown"]}}},"genres":{"type":"array","items":{"type":"string"}},"category":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"ageRange":{"type":["string","null"]},"lineup":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]},"image":{"type":["string","null"],"format":"uri"},"ticketsUrl":{"type":["string","null"],"format":"uri"}}}}}}}},"404":{"description":"Not found"}}}},"/api/public/venues":{"get":{"operationId":"listVenues","summary":"Venues with upcoming events","parameters":[{"name":"city","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":100}}],"responses":{"200":{"description":"Venues, most active first"}}}},"/api/public/artists":{"get":{"operationId":"listArtists","summary":"Artists with upcoming events","parameters":[{"name":"city","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":100}}],"responses":{"200":{"description":"Artists with their upcoming events"}}}},"/api/public/cities":{"get":{"operationId":"listCities","summary":"Cities with events","responses":{"200":{"description":"Cities BLUPRNT is live in"}}}}}}