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.

GET https://api.softon.dev/v1/venues/{id} Copy

Parameters

ParameterTypeDescription
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"

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

FieldTypeDescription
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

v1 · stable
Send the request to see a response.