DrinkedIn Night Out

Returns reference data for the night-out planner: some places with validated venues (not a ranking and not a coverage claim; places, styles and vibes are built from the venues on record and the planner's style and vibe tables), supported vibes, route styles, notes on addresses and place names, and the relay rules this server publishes (validated venues only, no invented details, legal drinking age where they are). Not required before a plan. Read-only and free.

Plans a walkable 2-4 stop night out around a place, using only venues DrinkedIn has validated against an official licence register or premises census, or the venue's own site, and books nothing. Free. Side effect: saves the planned route (public venue data only, 30 days) for its share link, returned as route.plan_url; the user's location is not saved. Input, most reliable first: a point as latitude and longitude; with no coordinates, a free-text street address or landmark in address, geocoded to one point and planned like coordinates (coordinates win if both are given); or a place name in city, with region or country, which plans only when it identifies one place. A typed address is sent to a public geocoding service (OpenStreetMap Nominatim), which ranks matches and does not confirm them; the reply's geocoded_as and geocoded_point say what it matched. A name several places share returns needs_input with labelled choices, each with a place_key for the next call; the tool does not pick between them. Optional: stops, max_walk_m, style, vibes (both listed by drinkedin_get_guide, which is not a required first call) and exclude_ids to swap a stop. Output: a status (planned, partial, needs_input or no_coverage), the ordered stops with name, address, kind of place and walking minutes, meaning and say_to_owner lines, next steps and notices. Walking times are estimates (straight line x 1.3). Opening hours and prices are not known and not asserted; each stop sets hours_verified and prices_verified, both false unless that stop names a verification source, and points to the venue for them (its own site when the stop has own_site). Plans are for adults of legal drinking age where they are. legal_drinking_age is the age on record for the venues' country, or null; no reply states an age as a number. A reply contains only the stops the tool returns, with no venues, details or place names from other sources.