Docs / Event Data API / Endpoints / Retrieve a venue
Retrieve a venue
Returns one venue with its geocoded position. Venues are shared across events, so this is worth caching rather than refetching per event.
Parameters
| Parameter | Type | Description |
|---|---|---|
id required |
string | Venue slug from an event's venue.id. |
Request
curl https://api.softon.dev/v1/venues/museum-center \
-H "Authorization: Bearer $SOFTON_KEY"
req, _ := http.NewRequestWithContext(ctx, "GET", "https://api.softon.dev/v1/venues/museum-center", nil) req.Header.Set("Authorization", "Bearer "+os.Getenv("SOFTON_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var page struct { Data Venue `json:"data"` Meta struct{ Next *string `json:"next"` } `json:"meta"` } if err := json.NewDecoder(res.Body).Decode(&page); err != nil { log.Fatal(err) }
import json, os, urllib.parse, urllib.request url = "https://api.softon.dev/v1/venues/museum-center" req = urllib.request.Request(url, headers={ "Authorization": "Bearer " + os.environ["SOFTON_KEY"], }) page = json.load(urllib.request.urlopen(req)) # page["data"] is the object; page["error"] is None on success
const url = new URL("https://api.softon.dev/v1/venues/museum-center"); const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.SOFTON_KEY}` }, }); if (!res.ok) throw new Error(`${res.status} ${await res.text()}`); const { data, meta } = await res.json();
Response
The envelope is identical on every softon.dev API: data, meta, error. Only the shape inside data changes per dataset — see the response envelope.
{
"data": {
"id": "museum-center",
"name": "Museum Center",
"address": null,
"lat": 40.3698087,
"lng": 49.8425258
},
"meta": { "request_id": "req_9Fv3" },
"error": null
}
Fields of data
| Field | Type | Description |
|---|---|---|
id |
string · nullable | Slugified venue name. Venues have no source-issued id. |
name |
string | Venue name as published. |
address |
string · nullable | Street address as published. |
lat |
number · nullable | Latitude, WGS 84. |
lng |
number · nullable | Longitude, WGS 84. |
Try it
Send the request to see a response.