Skip to content

GET /v1/events/:eventId ​

Returns the rich detail for a single event. The list responses carry enough to render a card; this endpoint adds the full description, the venue, the showing times, endTime/isOngoing, and — importantly — the real ticket link, which the event list does not carry.

http
GET /v1/events/:eventId
Authorization: Bearer <token>

Path and query ​

ParameterTypeRequiredNotes
eventIdstringyesEvent identifier from a list response.
hotelPlaceIdstringnoReference hotel; when supplied, distanceFromHotel is computed in miles.
bash
curl -s "https://api.overlookhospitality.com/v1/events/6430352625996601?hotelPlaceId=123456" \
  -H "Authorization: Bearer $OVERLOOK_TOKEN"

Response 200 OK ​

json
{
  "event": {
    "eventId": "6430352625996601",
    "title": "Monday Night Comedy Show",
    "date": "2026-10-12",
    "time": "19:30",
    "endTime": null,
    "isOngoing": false,
    "times": ["19:30", "21:30"],
    "category": "comedy",
    "subcategory": ["stand-up-solo"],
    "tags": ["date-night", "indoor"],
    "venue": "St. Marks Comedy Club",
    "venuePlaceId": "4845854409055927",
    "venueAddress": "12 Saint Marks Pl",
    "locality": "Greenwich Village",
    "region": "NY",
    "timezone": "America/New_York",
    "neighborhood": "East Village",
    "latitude": 40.7291,
    "longitude": -73.9892,
    "blurb": "Monday Night Comedy Show at St. Marks Comedy Club…",
    "description": "Monday Night Comedy Show at St. Marks Comedy Club, a speakeasy brickwall performance venue…",
    "imageUrl": "https://…",
    "isFree": false,
    "ticketPrice": { "min": 25, "max": 45, "currency": "USD" },
    "url": "http://www.stmarkscomedyclub.com/",
    "detailUrl": "https://www.tixr.com/groups/stmarkscomedyclub/events/…",
    "ticketUrl": "https://www.tixr.com/groups/stmarkscomedyclub/events/…",
    "calendarUrl": "http://www.stmarkscomedyclub.com/",
    "source": "stmarkscomedyclub.com",
    "distanceFromHotel": 2.6
  }
}

The example is abridged. See Data types for every field.

Provenance ​

  • Timing, ticket/detail/calendar links, ticketPrice, description, image come from the event record. isFree is true, false, or null for unknown. ticketPrice is { min, max, currency } when the source states an amount and null otherwise (an event that is explicitly free never carries a price).
  • Venue name, address, and coordinates are resolved from our place data. The venue is enrichment: the event still renders when the venue lookup fails.
  • All outbound links are sanitized to absolute http(s) URLs; non-http values become null.

Errors ​

All errors use the shared envelope and codes; see Errors. This route's own code is 404 event_not_found — no such event.

Overlook Hospitality API