{ "openapi": "3.1.0", "info": { "title": "Burning Man Public API", "description": "\nThis is the public API V2 for Burning Man app developers. Currently you can get listings of:\n\n- Camps\n- Art Installations\n- Events\n\nIn order to access this API you must request an API key here: https://api.burningman.org/request/. All apps that use this API must follow the [Burning Man Terms of Service For APIs and Datasets](https://innovate.burningman.org/terms-of-service-for-burning-man-apis-and-datasets/).\n\nIf you have questions please contact innovate@burningman.org or [Join the Burning Man Innovators Discussion List](https://groups.google.com/a/burningman.org/forum/#!forum/bman-innovators-list).\n\nAPI V2 is more realiable, performant, and maintained than API V1. API V1 will be deprecated after the 2025 event cycle. If you have any issues with API V2 please let us know! Email innovate@burningman.org or post a message to the discussion list.\n\nAPI V1 documentation is [available here](https://documenter.getpostman.com/view/588007/S11PrGRV).\n\n### Authentication\nAll requests to the API must include your API key in the `X-API-Key` header. You can obtain an API key by [requesting one here](https://api.burningman.org/request/).\n\n### Request Example\n```bash\ncurl -X GET \"https://api.burningman.org/api/camp?year=2024\" -H \"X-API-Key: your_api_key_here\"\n```\n", "version": "2.0.0" }, "paths": { "/api/art": { "get": { "summary": "Get Art", "operationId": "get_art", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "year", "in": "query", "required": true, "schema": { "type": "integer", "exclusiveMinimum": 2014, "description": "Year of event", "title": "Year" }, "description": "Year of event" }, { "name": "category", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" } }, { "name": "program", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Program" } }, { "name": "search", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Search" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ArtModel" }, "title": "Response Get Art" } } } }, "404": { "description": "Item not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "detail": { "type": "string" } } }, "example": { "detail": "Item not found" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "type": "object", "required": [ "error", "message" ], "properties": { "error": { "type": "string" }, "message": { "type": "array", "items": { "type": "string" } }, "detail": { "type": "string" } } } } } }, "429": { "description": "Rate limit exceeded", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "schema": { "type": "integer" } } } } } } }, "/api/art/{uid}": { "get": { "summary": "Get Art By Uid", "operationId": "get_art_by_uid", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "uid", "in": "path", "required": true, "schema": { "type": "string", "minLength": 18, "maxLength": 18, "description": "Unique identifier for art", "title": "Uid" }, "description": "Unique identifier for art" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArtModel" } } } }, "404": { "description": "Item not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "detail": { "type": "string" } } }, "example": { "detail": "Item not found" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "type": "object", "required": [ "error", "message" ], "properties": { "error": { "type": "string" }, "message": { "type": "array", "items": { "type": "string" } }, "detail": { "type": "string" } } } } } }, "429": { "description": "Rate limit exceeded", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "schema": { "type": "integer" } } } } } } }, "/api/camp": { "get": { "summary": "Get Camp", "operationId": "get_camp", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "year", "in": "query", "required": true, "schema": { "type": "integer", "exclusiveMinimum": 2014, "description": "Year of event", "title": "Year" }, "description": "Year of event" }, { "name": "search", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Search" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CampModel" }, "title": "Response Get Camp" } } } }, "404": { "description": "Item not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "detail": { "type": "string" } } }, "example": { "detail": "Item not found" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "type": "object", "required": [ "error", "message" ], "properties": { "error": { "type": "string" }, "message": { "type": "array", "items": { "type": "string" } }, "detail": { "type": "string" } } } } } }, "429": { "description": "Rate limit exceeded", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "schema": { "type": "integer" } } } } } } }, "/api/camp/{uid}": { "get": { "summary": "Get Camp By Uid", "operationId": "get_camp_by_uid", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "uid", "in": "path", "required": true, "schema": { "type": "string", "minLength": 18, "maxLength": 18, "description": "Unique identifier for camp", "title": "Uid" }, "description": "Unique identifier for camp" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CampModel" } } } }, "404": { "description": "Item not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "detail": { "type": "string" } } }, "example": { "detail": "Item not found" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "type": "object", "required": [ "error", "message" ], "properties": { "error": { "type": "string" }, "message": { "type": "array", "items": { "type": "string" } }, "detail": { "type": "string" } } } } } }, "429": { "description": "Rate limit exceeded", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "schema": { "type": "integer" } } } } } } }, "/api/event": { "get": { "summary": "Get Event", "operationId": "get_event", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "year", "in": "query", "required": true, "schema": { "type": "integer", "exclusiveMinimum": 2008, "description": "Year of event", "title": "Year" }, "description": "Year of event" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/EventModel" }, "title": "Response Get Event" } } } }, "404": { "description": "Item not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "detail": { "type": "string" } } }, "example": { "detail": "Item not found" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "type": "object", "required": [ "error", "message" ], "properties": { "error": { "type": "string" }, "message": { "type": "array", "items": { "type": "string" } }, "detail": { "type": "string" } } } } } }, "429": { "description": "Rate limit exceeded", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "schema": { "type": "integer" } } } } } } }, "/api/event/{uid}": { "get": { "summary": "Get Event By Uid", "operationId": "get_event_by_uid", "security": [ { "APIKeyHeader": [] } ], "parameters": [ { "name": "uid", "in": "path", "required": true, "schema": { "type": "string", "title": "Uid" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventModel" } } } }, "404": { "description": "Item not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "detail": { "type": "string" } } }, "example": { "detail": "Item not found" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "type": "object", "required": [ "error", "message" ], "properties": { "error": { "type": "string" }, "message": { "type": "array", "items": { "type": "string" } }, "detail": { "type": "string" } } } } } }, "429": { "description": "Rate limit exceeded", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "schema": { "type": "integer" } } } } } } } }, "components": { "schemas": { "ArtImageModel": { "properties": { "thumbnail_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thumbnail Url" }, "gallery_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Gallery Ref" } }, "type": "object", "required": [ "thumbnail_url" ], "title": "ArtImageModel" }, "ArtLocationModel": { "properties": { "hour": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Hour" }, "minute": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Minute" }, "distance": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Distance" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" }, "gps_latitude": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Gps Latitude" }, "gps_longitude": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Gps Longitude" } }, "type": "object", "required": [ "hour", "minute", "distance", "category", "gps_latitude", "gps_longitude" ], "title": "ArtLocationModel" }, "ArtModel": { "properties": { "uid": { "type": "string", "title": "Uid" }, "name": { "type": "string", "title": "Name" }, "year": { "type": "integer", "title": "Year" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url" }, "contact_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Contact Email" }, "hometown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Hometown" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "artist": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Artist" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" }, "program": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Program" }, "donation_link": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Donation Link" }, "location": { "anyOf": [ { "$ref": "#/components/schemas/ArtLocationModel" }, { "type": "null" } ], "description": "Location of art installation" }, "location_string": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Location String" }, "images": { "anyOf": [ { "items": { "$ref": "#/components/schemas/ArtImageModel" }, "type": "array" }, { "type": "null" } ], "title": "Images", "default": [] }, "guided_tours": { "type": "boolean", "title": "Guided Tours", "description": "Included in art tours", "default": false }, "self_guided_tour_map": { "type": "boolean", "title": "Self Guided Tour Map", "description": "Included in self-guided tour map", "default": false } }, "type": "object", "required": [ "uid", "name", "year" ], "title": "ArtModel", "examples": [ { "artist": "Caroline Ghosn", "category": "Open Playa", "contact_email": "volunteer@2024temple.com", "description": "The Temple of Together is about the light that emerges when we come together with all parts of ourselves and with the oneness we share with every other living being. In this time of global challenge and conflict, she invites each of us to unfurl under her protection and be seen, loved, and inspired.", "donation_link": "https://crowdfundr.com/temple2024", "guided_tours": true, "hometown": "Oakland, CA", "images": [ { "thumbnail_url": "https://burningman.widen.net/content/da2cbqbalc/jpeg/a2IVI0000008m7V2AQ-Final.jpeg?w=640&keep=c&crop=yes&color=cccccc&quality=80&u=r3rtjx" } ], "location": { "category": "Open Playa", "distance": 2500, "gps_latitude": 40.79179890754886, "gps_longitude": -119.1976993927176, "hour": 12, "minute": 0 }, "location_string": "12:00 2500', Open Playa", "name": "Temple of Together", "program": "Honorarium", "self_guided_tour_map": true, "uid": "a2IVI0000008m7V2AQ", "url": "http://www.2024temple.com", "year": 2024 } ] }, "CampImageModel": { "properties": { "thumbnail_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thumbnail Url" } }, "type": "object", "title": "CampImageModel" }, "CampLocationModel": { "properties": { "frontage": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Frontage", "description": "One of the following: Esplanade, 1:00, 1:15, 1:30, 1:45, 10:00, 10:15, 10:30, 10:45, 11:00, 11:15, 11:30, 11:45, 12:00, 12:15, 12:30, 12:45, 2:00, 2:15, 2:30, 2:45, 3:00, 3:15, 3:30, 3:45, 4:00, 4:15, 4:30, 4:45, 5:00, 5:15, 5:30, 5:45, 6:00, 6:15, 6:30, 6:45, 7:00, 7:15, 7:30, 7:45, 8:00, 8:15, 8:30, 8:45, 9:00, 9:15, 9:30, 9:45, A, B, C, D, E, F, G, H, I, J, K, L, 9:00 B Plaza, 9:00 G Plaza, 3:00 B Plaza, 3:00 G Plaza, 4:30 B Plaza, 4:30 G Plaza, 6:00 G Plaza, 7:30 B Plaza, 7:30 G Plaza, 9:00 Portal, 3:00 Portal, 7:30 Portal, 4:30 Portal, 6:00 Portal, Center Camp Plaza, Rte 66 Z1, Rte 66 Z2, Rte 66 Z3, Rte 66 Z4, Rte 66 Z5, Rte 66 Z6, Rte 66, Airport Road, Rte 66 Qrtr One, Rte 66 Qrtr Two, Rte 66 Qrtr Three, Rte 66 Qrtr Four, Rod's Ring Road" }, "intersection": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Intersection", "description": "One of the following: Esplanade, 1:00, 1:15, 1:30, 1:45, 2:00, 2:15, 2:30, 2:45, 3:00, 3:15, 3:30, 3:45, 4:00, 4:15, 4:30, 4:45, 5:00, 5:15, 5:30, 5:45, 6:00, 6:15, 6:30, 6:45, 7:00, 7:15, 7:30, 7:45, 8:00, 8:15, 8:30, 8:45, 9:00, 9:15, 9:30, 9:45, 10:00, 10:15, 10:30, 10:45, 11:00, 11:15, 11:30, 11:45, 12:00, 12:15, 12:30, 12:45, A, B, C, D, E, F, G, H, I, J, K, L, 9:00 Portal, 3:00 Portal, 7:30 Portal, 4:30 Portal, 6:00 Portal, Rte 66 Qrtr One, Rte 66 Qrtr Two, Rte 66 Qrtr Three, Rte 66 Qrtr Four" }, "intersection_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Intersection Type", "description": "'&' or '@'" }, "dimensions": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Dimensions" }, "exact_location": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Exact Location", "description": "One of the following: Mid-block facing man, Mid-block facing mountain, Corner - facing man & 2:00, Corner - facing man & 6:00, Corner - facing man & 10:00, Corner - facing mountain & 2:00, Corner - facing mountain & 6:00, Corner - facing mountain & 10:00, Mid-block facing 2:00, Mid-block facing 6:00, Mid-block facing 10:00" } }, "type": "object", "title": "CampLocationModel" }, "CampModel": { "properties": { "uid": { "type": "string", "title": "Uid" }, "name": { "type": "string", "title": "Name" }, "year": { "type": "integer", "title": "Year" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url" }, "contact_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Contact Email" }, "hometown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Hometown" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "landmark": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Landmark", "description": "To find our camp, look for the ________." }, "location": { "anyOf": [ { "$ref": "#/components/schemas/CampLocationModel" }, { "type": "null" } ], "description": "Location of camp" }, "location_string": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Location String" }, "images": { "anyOf": [ { "items": { "$ref": "#/components/schemas/CampImageModel" }, "type": "array" }, { "type": "null" } ], "title": "Images", "default": [] } }, "type": "object", "required": [ "uid", "name", "year" ], "title": "CampModel", "examples": [ { "contact_email": "census@burningman.org", "description": "The Census has been collecting information about the population of Black Rock City since 2002. The results of the Census from previous years will be on display at the Census Lab on playa and published in the Population Analysis Report on our website at http://blackrockcitycensus.org", "hometown": "Reno", "images": [ { "thumbnail_url": "https://burningman.widen.net/content/da2cbqbalc/jpeg/a1XVI000001vN7N2AU-Final.jpeg?w=640&keep=c&crop=yes&color=cccccc&quality=80&u=r3rtjx" } ], "landmark": "pink Census signs and colorful data displays", "location": { "dimensions": "75 x 110", "exact_location": "Mid-block facing 10:00", "frontage": "Esplanade", "intersection": "6:30", "intersection_type": "&" }, "location_string": "Esplanade & 6:30", "name": "Census", "uid": "a1XVI000001vN7N2AU", "url": "http://census.burningman.org", "year": 2024 } ] }, "EventModel": { "properties": { "uid": { "type": "string", "title": "Uid" }, "title": { "type": "string", "title": "Title" }, "event_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Event Id" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "event_type": { "anyOf": [ { "$ref": "#/components/schemas/EventTypeModel" }, { "type": "null" } ] }, "year": { "type": "integer", "title": "Year" }, "print_description": { "type": "string", "title": "Print Description", "default": "" }, "slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Slug" }, "hosted_by_camp": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Hosted By Camp", "description": "Camp uid" }, "located_at_art": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Located At Art", "description": "Art uid" }, "other_location": { "type": "string", "title": "Other Location", "default": "" }, "check_location": { "type": "boolean", "title": "Check Location", "default": false }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url" }, "all_day": { "type": "boolean", "title": "All Day", "default": false }, "contact": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Contact" }, "occurrence_set": { "anyOf": [ { "items": { "$ref": "#/components/schemas/EventOccurrenceModel" }, "type": "array" }, { "type": "null" } ], "title": "Occurrence Set" } }, "type": "object", "required": [ "uid", "title", "year" ], "title": "EventModel", "examples": [ { "all_day": false, "check_location": false, "contact": "john.valentino@burningman.org", "description": "Burning Man Project’s official artist storytelling series. Conversations & panel discussions with playa artists.", "event_id": 47160, "event_type": { "abbr": "arts", "label": "Arts & Crafts" }, "hosted_by_camp": "a1XVI0000022UVW2A2", "occurrence_set": [ { "end_time": "2024-08-27T14:30:00-07:00", "start_time": "2024-08-27T13:00:00-07:00" }, { "end_time": "2024-08-28T14:30:00-07:00", "start_time": "2024-08-28T13:00:00-07:00" }, { "end_time": "2024-08-29T14:30:00-07:00", "start_time": "2024-08-29T13:00:00-07:00" } ], "other_location": "", "print_description": "", "slug": "5ye8cMz8UPJU7L9n2tpe-art-speaks-artist-storytelling", "title": "Art Speaks Artist Storytelling", "uid": "5ye8cMz8UPJU7L9n2tpe", "year": 2024 } ] }, "EventOccurrenceModel": { "properties": { "start_time": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Start Time" }, "end_time": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "End Time" } }, "type": "object", "required": [ "start_time", "end_time" ], "title": "EventOccurrenceModel" }, "EventTypeModel": { "properties": { "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Label" }, "abbr": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Abbr" } }, "type": "object", "required": [ "label", "abbr" ], "title": "EventTypeModel" } }, "securitySchemes": { "APIKeyHeader": { "type": "apiKey", "in": "header", "name": "X-API-Key" } } } }