Mercantry Registry

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['booking_id'], 'properties': {'reason': {'type': 'string'}, 'booking_id': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['merchant_id'], 'properties': {'merchant_id': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['booking_id'], 'properties': {'booking_id': {'type': 'string'}, 'include_events': {'type': 'boolean'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['merchant_id'], 'properties': {'merchant_id': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['booking_id'], 'properties': {'datetime': {'type': 'string', 'description': "New requested time, ISO-8601; naive means the merchant's local wall time"}, 'booking_id': {'type': 'string'}, 'party_size': {'type': 'integer', 'minimum': 1}, 'window_minutes': {'type': 'integer', 'maximum': 240, 'minimum': 0}, 'accept_option_index': {'type': 'integer', 'minimum': 0, 'description': 'Index into needs_input_options to accept'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['merchant_id', 'party_size', 'datetime', 'reservation_name'], 'properties': {'contact': {'type': 'string', 'description': 'Optional phone/email for confirmation relay to the end human'}, 'datetime': {'type': 'string', 'description': "Requested time, ISO-8601. Naive ('2026-07-18T19:00') means the merchant's LOCAL wall time (see the merchant's timezone field); an explicit offset ('2026-07-18T19:00:00+09:00') is also accepted"}, 'party_size': {'type': 'integer', 'minimum': 1}, 'merchant_id': {'type': 'string'}, 'callback_url': {'type': 'string', 'format': 'uri', 'description': 'Webhook URL for booking state-change events'}, 'window_minutes': {'type': 'integer', 'maximum': 240, 'minimum': 0, 'description': 'Acceptable +/- window around datetime'}, 'sandbox_outcome': {'enum': ['confirmed', 'no_answer', 'counter_offer', 'fully_booked', 'merchant_declined', 'bad_data'], 'type': 'string', 'description': "TEST ONLY, sandbox merchants (sandbox: true): force the simulated call's result so you can exercise a specific branch on demand — confirmed, no_answer (retries then fails), counter_offer (pauses in needs_input), fully_booked, merchant_declined, bad_data. Rejected for real merchants; omit it in production"}, 'reservation_name': {'type': 'string', 'description': 'Name for the reservation'}, 'special_requests': {'type': 'string', 'maxLength': 280}, 'client_reference_id': {'type': 'string', 'maxLength': 128, 'minLength': 1, 'description': 'Your unique ID for this booking request (a UUID is ideal). Retrying with the same value returns the existing booking (idempotent_replay: true) instead of creating a duplicate; the same value with different parameters is rejected as client_reference_conflict'}, 'accept_within_window': {'type': 'boolean', 'description': 'Auto-accept merchant counter-offers inside the window (recommended: true)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'lat': {'type': 'number', 'description': 'Latitude for geo-radius filter (requires lng and radius_km)'}, 'lng': {'type': 'number'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'offset': {'type': 'integer', 'minimum': 0}, 'open_at': {'type': 'string', 'description': "ISO-8601 datetime; only merchants open at this time. With an explicit offset ('2026-07-18T19:00:00+09:00' or trailing Z) the instant is evaluated in each merchant's own timezone; without one it means each merchant's local wall clock"}, 'sandbox': {'type': 'boolean', 'description': 'Filter by merchant kind. true = sandbox test merchants only (safe integration targets: they book end-to-end and return a SIMULATED confirmation, never dialing a real venue). false = real merchants only — use this for any booking a human will act on. Omitted = both. Every result carries `sandbox`; never present a sandbox confirmation to a user as a real reservation.'}, 'order_by': {'enum': ['merchant_id', 'distance'], 'type': 'string'}, 'radius_km': {'type': 'number', 'description': 'Radius in km around lat/lng'}, 'party_size': {'type': 'integer', 'minimum': 1, 'description': 'Only merchants that can seat this party size'}, 'cuisine_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': "Match ANY of these cuisines, e.g. ['japanese','korean']"}, 'neighborhood': {'type': 'string', 'description': "Exact neighborhood name, e.g. 'Mission'"}, 'bookable_only': {'type': 'boolean', 'description': 'Only merchants the registry can book right now (phone-verified, accepts reservations, not opted out)'}, 'attribute_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': "Match ALL of these attributes, e.g. ['outdoor_seating','vegetarian_friendly']"}, 'price_band_max': {'type': 'integer', 'maximum': 4, 'minimum': 1}, 'price_band_min': {'type': 'integer', 'maximum': 4, 'minimum': 1}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['booking_id', 'reservation_honored'], 'properties': {'free_text': {'type': 'string', 'maxLength': 500}, 'booking_id': {'type': 'string'}, 'would_repeat': {'type': 'boolean'}, 'seated_on_time': {'type': 'boolean'}, 'matched_description': {'type': 'boolean', 'description': "Did the merchant match the registry's description?"}, 'reservation_honored': {'type': 'boolean', 'description': 'Did the merchant honor the reservation?'}}, 'additionalProperties': False}