event_id, either the event’s UUID or its
numeric eventId, as a string. With it, the tool reads the venues already on
that event or leaves them out of the results. An event you cannot read returns
the same not-found error as one that does not exist.
Catalog data has no fixed refresh date. If a venue’s own email or proposal
disagrees with the catalog, the venue’s own words win.
search_venues
Finds up to five new hotels near a named venue or landmark. This only presents
choices. Once the person picks venues, call
send_rfp with their names.
Returns
anchor, radiusMiles, walk, venues, matchCount and a note
that says how the search was measured.
If more than one catalog venue could be the anchor, the call returns an error
instead. Its first text part says to list the options. A second text part is
JSON with options, the candidate venues. List them by name and location, ask
the person which one they mean, then search again with a more specific
near_venue or city.
get_venue_facts
Reads catalog facts about named venues: meeting rooms with capacity by setup
(banquet, classroom, reception, theater, boardroom, u-shape) and size, total
meeting space, guestrooms and suites, amenities, AV, parking, miles from the
airport, ratings, chain and brand, and website.
Returns
venues, each with its facts, its meetingRooms (moreRooms counts
the ones left out), a dashboardUrl, and fit when you passed needs. Each
fit verdict is fits, short or unknown, with the stored figure behind it.
An unknown verdict means the catalog has no room data, so say that rather
than guess. With venues, it also returns lookups (what each name matched),
notInCatalog (names the catalog does not have, with the nearest names in that
city) and a note.
get_venue_inventory
Reports what the catalog holds in up to 10 cities. Use it for “is there enough
in Napa” or “are there hotels that fit 200”, including before there is an
event. Counts describe the catalog, not availability on your dates, and carry
no prices. For a venue already on the event, use
get_venue_facts.
Returns
cities, each with how many venues match, how many are on the client’s
preferred list, the areas the matches fall in, and a sample with guestrooms,
meeting rooms, largest-room capacity and star rating. Also returns
matchCount, shown, a searchUrl when there is an event, and a note.
get_typical_rates
Reports what hotels in a city have quoted Nowadays clients, as aggregates
only. It never returns one hotel’s rate. For a venue on the event, use
get_proposals.
Returns the pre-tax nightly group rate as
low, median and high (the 25th,
50th and 75th percentiles) in currency, with quotes, hotels,
oldestQuote and newestQuote. fbMinimumPerAttendee gives the F&B minimums
those hotels set per attendee, and allInBudget gives what clients budgeted
all-in per attendee on past events. Each part has a kind of range when
there were enough quotes to report, and a note that says how to present it.