Appearance
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
| Parameter | Type | Required | Notes |
|---|---|---|---|
eventId | string | yes | Event identifier from a list response. |
hotelPlaceId | string | no | Reference 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.isFreeistrue,false, ornullfor unknown.ticketPriceis{ min, max, currency }when the source states an amount andnullotherwise (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 becomenull.
Errors
All errors use the shared envelope and codes; see Errors. This route's own code is 404 event_not_found — no such event.