NUM

{'type': 'object', 'required': ['place_id'], 'properties': {'date': {'type': 'string', 'description': "Optional: YYYY-MM-DD, to prefill the venue's booking page."}, 'time': {'type': 'string', 'description': 'Optional: HH:MM 24-hour, local to the venue.'}, 'place_id': {'type': 'string', 'description': 'The place_id returned by num_search_places.'}, 'party_size': {'type': 'integer', 'maximum': 40, 'minimum': 1, 'description': "Optional: people in the party, to prefill the venue's booking page."}}}

{'type': 'object', 'properties': {}}

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1}, 'offset': {'type': 'integer', 'minimum': 0}, 'status': {'enum': ['pending', 'approved', 'rejected', 'duplicate', 'withdrawn'], 'type': 'string'}}}

{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Free text matched against the place name.'}, 'area': {'type': 'string', 'description': "A neighbourhood inside the destination, e.g. 'Kata' or 'Soho'."}, 'city': {'type': 'string', 'description': "A NUM destination, e.g. 'Phuket', 'Edinburgh', 'Bangkok', 'London'. Required unless country is given."}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max results, default 20, cap 50.'}, 'country': {'type': 'string', 'description': "ISO-2 code or name, e.g. 'TH' or 'Thailand'. Searches every NUM destination in that country."}, 'category': {'type': 'string', 'description': "e.g. 'Restaurant', 'Bar', 'Hotel', 'Spa', 'Tour'."}}}

{'type': 'object', 'required': ['relationship', 'name', 'country', 'city'], 'properties': {'city': {'type': 'string'}, 'name': {'type': 'string', 'description': 'Trading name as it appears on the door.'}, 'email': {'type': 'string', 'description': 'Only if the business has published it. Do not derive it from the domain name.'}, 'hours': {'type': 'string'}, 'phone': {'type': 'string'}, 'address': {'type': 'string'}, 'country': {'type': 'string'}, 'website': {'type': 'string'}, 'vertical': {'type': 'string', 'description': 'restaurant, cafe, bar, hotel, spa, boat, tour, shop, transport, clinic, gym, attraction, other…'}, 'languages': {'type': 'array', 'items': {'type': 'string'}}, 'description': {'type': 'string'}, 'price_range': {'type': 'string'}, 'callback_url': {'type': 'string', 'description': 'NUM POSTs the review decision here.'}, 'external_ref': {'type': 'string', 'description': 'Your own reference for this business. Re-sending it edits the pending submission instead of creating a duplicate.'}, 'relationship': {'enum': ['owner', 'authorized_agent', 'third_party'], 'type': 'string', 'description': "'owner' if you run it, 'authorized_agent' if the owner engaged you, 'third_party' if you neither own nor represent it."}}}

{'type': 'object', 'required': ['title'], 'properties': {'kind': {'enum': ['promo', 'special', 'event', 'ad'], 'type': 'string'}, 'terms': {'type': 'string'}, 'title': {'type': 'string', 'description': 'The single line a traveller reads.'}, 'detail': {'type': 'string'}, 'ends_at': {'type': 'string'}, 'promo_ref': {'type': 'string', 'description': 'Your own reference for this promotion, for idempotent edits.'}, 'starts_at': {'type': 'string', 'description': '2026-08-01 or 2026-08-01T18:00:00Z.'}, 'discount_pct': {'type': 'integer', 'maximum': 90, 'minimum': 0}, 'external_ref': {'type': 'string', 'description': 'Alternative to submission_id: the reference you used for the business.'}, 'submission_id': {'type': 'string', 'description': 'From num_submit_business.'}}}