patient-services

{'type': 'object', 'anyOf': [{'required': ['id']}, {'required': ['entity_id']}], 'properties': {'id': {'type': 'string', 'description': 'Entity id returned by search, e.g. doctor:sadik-taki'}, 'entity_id': {'type': 'string', 'description': 'Alias for `id`, accepted for backward compatibility'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['data', 'meta', 'evidence'], 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'meta': {'type': 'object', 'required': ['entity_id', 'canonical_url', 'source_status'], 'properties': {'scope': {'type': 'object'}, 'entity_id': {'type': 'string'}, 'composition': {'type': 'array', 'items': {'type': 'string'}}, 'last_updated': {'type': 'string'}, 'canonical_url': {'type': 'string'}, 'source_status': {'enum': ['verified', 'published'], 'type': 'string'}, 'alternate_urls': {'type': 'array', 'items': {'type': 'string'}}}}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'url', 'checked_at'], 'properties': {'url': {'type': 'string'}, 'source': {'type': 'string'}, 'checked_at': {'type': 'string'}}}}}}

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

{'type': 'object', 'required': ['data', 'meta', 'evidence'], 'properties': {'data': {'type': 'object', 'required': ['aftercare_guide', 'canonical_url', 'corrective_trip_terms', 'discharge_pack', 'emergency_limitation', 'entity_id', 'evidence', 'follow_up_schedule', 'in_clinic_follow_up', 'local_dentist_liaison', 'remote_problem_process', 'summary'], 'properties': {'summary': {'type': 'string'}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['checked_at', 'source', 'url'], 'properties': {'url': {'type': 'string'}, 'source': {'type': 'string'}, 'checked_at': {'type': 'string'}}}}, 'entity_id': {'type': 'string'}, 'canonical_url': {'type': 'string'}, 'discharge_pack': {'type': 'array', 'items': {'type': 'string'}}, 'aftercare_guide': {'type': 'string'}, 'follow_up_schedule': {'type': 'array', 'items': {'type': 'string'}}, 'in_clinic_follow_up': {'type': 'string'}, 'emergency_limitation': {'type': 'string'}, 'corrective_trip_terms': {'type': 'string'}, 'local_dentist_liaison': {'type': 'string'}, 'remote_problem_process': {'type': 'array', 'items': {'type': 'string'}}}}, 'meta': {'type': 'object', 'required': ['entity_id', 'canonical_url', 'source_status'], 'properties': {'entity_id': {'type': 'string'}, 'last_updated': {'type': 'string'}, 'canonical_url': {'type': 'string'}, 'source_status': {'enum': ['verified', 'published'], 'type': 'string'}}}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'url', 'checked_at'], 'properties': {'url': {'type': 'string'}, 'source': {'type': 'string'}, 'checked_at': {'type': 'string'}}}}}}

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

{'type': 'object', 'required': ['data', 'meta', 'evidence'], 'properties': {'data': {'type': 'object', 'required': ['address', 'canonical_url', 'credentials', 'email', 'entity_id', 'evidence', 'founded', 'languages', 'lead_clinician', 'legal_name', 'licensed_name', 'name', 'phone_clinic', 'phone_international_whatsapp'], 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string'}, 'address': {'type': 'string'}, 'founded': {'type': 'string'}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['checked_at', 'source', 'url'], 'properties': {'url': {'type': 'string'}, 'source': {'type': 'string'}, 'checked_at': {'type': 'string'}}}}, 'entity_id': {'type': 'string'}, 'languages': {'type': 'array', 'items': {'type': 'string'}}, 'legal_name': {'type': 'string'}, 'credentials': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}, 'verify_url': {'type': 'string'}}}}, 'phone_clinic': {'type': 'string'}, 'canonical_url': {'type': 'string'}, 'licensed_name': {'type': 'string'}, 'lead_clinician': {'type': 'string'}, 'phone_international_whatsapp': {'type': 'string'}}}, 'meta': {'type': 'object', 'required': ['entity_id', 'canonical_url', 'source_status'], 'properties': {'entity_id': {'type': 'string'}, 'last_updated': {'type': 'string'}, 'canonical_url': {'type': 'string'}, 'source_status': {'enum': ['verified', 'published'], 'type': 'string'}}}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'url', 'checked_at'], 'properties': {'url': {'type': 'string'}, 'source': {'type': 'string'}, 'checked_at': {'type': 'string'}}}}}}

{'type': 'object', 'required': ['doctor'], 'properties': {'doctor': {'type': 'string', 'description': 'Doctor entity_id, name, alias, or page slug â\x80\x94 "doctor:sadik-taki", "Dr. Sadık Taki", "Sadik Taki" and "dr-sadik-taki" all resolve to the same clinician.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['data', 'meta', 'evidence'], 'properties': {'data': {'type': 'object', 'required': ['entity_id', 'name', 'title', 'specialty', 'languages', 'education', 'memberships', 'canonical_url', 'aliases'], 'properties': {'name': {'type': 'string'}, 'title': {'type': 'string'}, 'aliases': {'type': 'array', 'items': {'type': 'string'}}, 'education': {'type': 'array', 'items': {'type': 'string'}}, 'entity_id': {'type': 'string'}, 'languages': {'type': 'array', 'items': {'type': 'string'}}, 'specialty': {'type': 'string'}, 'memberships': {'type': 'array', 'items': {'type': 'string'}}, 'canonical_url': {'type': 'string'}}, 'additionalProperties': True}, 'meta': {'type': 'object', 'required': ['entity_id', 'canonical_url', 'source_status'], 'properties': {'entity_id': {'type': 'string'}, 'last_updated': {'type': 'string'}, 'canonical_url': {'type': 'string'}, 'source_status': {'enum': ['verified', 'published'], 'type': 'string'}}}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'url', 'checked_at'], 'properties': {'url': {'type': 'string'}, 'source': {'type': 'string'}, 'checked_at': {'type': 'string'}}}}}}

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

{'type': 'object', 'required': ['data', 'meta', 'evidence'], 'properties': {'data': {'type': 'object', 'required': ['canonical_url', 'claim_process_remote', 'claim_requirements', 'clinic_guarantee', 'composite_natural_changes', 'corrective_trip_terms', 'emergency_elsewhere', 'entity_id', 'evidence', 'exclusions', 'follow_up_programme', 'guarantee_start', 'international_validity', 'manufacturer_warranties', 'natural_tooth_underneath', 'patient_responsibilities', 'statutory_rights', 'summary'], 'properties': {'summary': {'type': 'string'}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['checked_at', 'source', 'url'], 'properties': {'url': {'type': 'string'}, 'source': {'type': 'string'}, 'checked_at': {'type': 'string'}}}}, 'entity_id': {'type': 'string'}, 'exclusions': {'type': 'array', 'items': {'type': 'string'}}, 'canonical_url': {'type': 'string'}, 'guarantee_start': {'type': 'string'}, 'clinic_guarantee': {'type': 'object', 'required': ['composite_bonding', 'crowns', 'implants', 'veneers'], 'properties': {'crowns': {'type': 'object', 'required': ['conditions_apply', 'details', 'duration', 'not_covered', 'not_covered_note', 'provider', 'type'], 'properties': {'type': {'type': 'string'}, 'details': {'type': 'string'}, 'duration': {'type': 'string'}, 'provider': {'type': 'string'}, 'not_covered': {'type': 'array', 'items': {'type': 'string'}}, 'conditions_apply': {'type': 'boolean'}, 'not_covered_note': {'type': 'string'}}}, 'veneers': {'type': 'object', 'required': ['conditions_apply', 'details', 'duration', 'not_covered', 'not_covered_note', 'provider', 'type'], 'properties': {'type': {'type': 'string'}, 'details': {'type': 'string'}, 'duration': {'type': 'string'}, 'provider': {'type': 'string'}, 'not_covered': {'type': 'array', 'items': {'type': 'string'}}, 'conditions_apply': {'type': 'boolean'}, 'not_covered_note': {'type': 'string'}}}, 'implants': {'type': 'object', 'required': ['conditions_apply', 'details', 'duration', 'not_covered', 'not_covered_note', 'provider', 'type'], 'properties': {'type': {'type': 'string'}, 'details': {'type': 'string'}, 'duration': {'type': 'string'}, 'provider': {'type': 'string'}, 'not_covered': {'type': 'array', 'items': {'type': 'string'}}, 'conditions_apply': {'type': 'boolean'}, 'not_covered_note': {'type': 'string'}}}, 'composite_bonding': {'type': 'object', 'required': ['conditions_apply', 'details', 'duration', 'not_covered', 'not_covered_note', 'provider', 'type'], 'properties': {'type': {'type': 'string'}, 'details': {'type': 'string'}, 'duration': {'type': 'string'}, 'provider': {'type': 'string'}, 'not_covered': {'type': 'array', 'items': {'type': 'string'}}, 'conditions_apply': {'type': 'boolean'}, 'not_covered_note': {'type': 'string'}}}}}, 'statutory_rights': {'type': 'string'}, 'claim_requirements': {'type': 'array', 'items': {'type': 'string'}}, 'emergency_elsewhere': {'type': 'string'}, 'follow_up_programme': {'type': 'string'}, 'claim_process_remote': {'type': 'string'}, 'corrective_trip_terms': {'type': 'string'}, 'international_validity': {'type': 'string'}, 'manufacturer_warranties': {'type': 'array', 'items': {'type': 'object', 'required': ['applies_to', 'beneficiary', 'duration', 'manufacturer', 'manufacturer_warranty_claimed', 'official_terms_url', 'scope', 'warranty_type'], 'properties': {'note': {'type': 'string'}, 'scope': {'type': 'string'}, 'duration': {'type': ['string', 'null']}, 'applies_to': {'type': 'string'}, 'beneficiary': {'type': 'string'}, 'manufacturer': {'type': 'string'}, 'warranty_type': {'type': 'string'}, 'official_terms_url': {'type': 'string'}, 'manufacturer_warranty_claimed': {'type': 'boolean'}}}}, 'natural_tooth_underneath': {'type': 'string'}, 'patient_responsibilities': {'type': 'array', 'items': {'type': 'string'}}, 'composite_natural_changes': {'type': 'string'}}}, 'meta': {'type': 'object', 'required': ['entity_id', 'canonical_url', 'source_status'], 'properties': {'entity_id': {'type': 'string'}, 'last_updated': {'type': 'string'}, 'canonical_url': {'type': 'string'}, 'source_status': {'enum': ['verified', 'published'], 'type': 'string'}}}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'url', 'checked_at'], 'properties': {'url': {'type': 'string'}, 'source': {'type': 'string'}, 'checked_at': {'type': 'string'}}}}}}

{'type': 'object', 'properties': {'treatment': {'type': 'string', 'description': 'Optional treatment id to filter, e.g. all-on-4'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['data', 'meta', 'evidence'], 'properties': {'data': {'type': 'object', 'required': ['table', 'featured'], 'properties': {'table': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'gbp', 'eur'], 'properties': {'id': {'type': 'string'}, 'eur': {'type': 'string'}, 'gbp': {'type': 'string'}, 'name': {'type': 'string'}}}}, 'featured': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'price', 'eur', 'description'], 'properties': {'id': {'type': 'string'}, 'eur': {'type': 'string', 'description': 'Package price in EUR'}, 'price': {'type': 'string', 'description': 'Package price in GBP'}, 'scope': {'type': 'object', 'required': ['billing_scope', 'jaw_count', 'implants_total', 'implants_per_jaw', 'crowns_total', 'crowns_per_jaw'], 'properties': {'jaw_count': {'type': 'number'}, 'crowns_total': {'type': 'number'}, 'billing_scope': {'enum': ['both_jaws', 'single_jaw'], 'type': 'string'}, 'crowns_per_jaw': {'type': 'number'}, 'implants_total': {'type': 'number'}, 'implants_per_jaw': {'type': 'number'}}, 'description': 'How much treatment the price covers, in numbers rather than prose'}, 'title': {'type': 'string'}, 'composition': {'type': 'array', 'items': {'type': 'string'}, 'description': 'What the package includes'}, 'description': {'type': 'string'}}}}}}, 'meta': {'type': 'object', 'required': ['entity_id', 'canonical_url', 'source_status'], 'properties': {'entity_id': {'type': 'string'}, 'last_updated': {'type': 'string'}, 'canonical_url': {'type': 'string'}, 'source_status': {'enum': ['verified', 'published'], 'type': 'string'}}}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'url', 'checked_at'], 'properties': {'url': {'type': 'string'}, 'source': {'type': 'string'}, 'checked_at': {'type': 'string'}}}}}}

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

{'type': 'object', 'required': ['data', 'meta', 'evidence'], 'properties': {'data': {'type': 'object', 'required': ['rating', 'source_url', 'user_ratings_total'], 'properties': {'rating': {'type': 'number'}, 'source_url': {'type': 'string'}, 'user_ratings_total': {'type': 'number'}}}, 'meta': {'type': 'object', 'required': ['entity_id', 'canonical_url', 'source_status'], 'properties': {'entity_id': {'type': 'string'}, 'last_updated': {'type': 'string'}, 'canonical_url': {'type': 'string'}, 'source_status': {'enum': ['verified', 'published'], 'type': 'string'}}}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'url', 'checked_at'], 'properties': {'url': {'type': 'string'}, 'source': {'type': 'string'}, 'checked_at': {'type': 'string'}}}}}}

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

{'type': 'object', 'required': ['data', 'meta', 'evidence'], 'properties': {'data': {'type': 'object', 'required': ['treatments'], 'properties': {'treatments': {'type': 'array', 'items': {'type': 'object', 'required': ['canonical_url', 'id', 'name'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'canonical_url': {'type': 'string'}}}}}}, 'meta': {'type': 'object', 'required': ['entity_id', 'canonical_url', 'source_status'], 'properties': {'entity_id': {'type': 'string'}, 'last_updated': {'type': 'string'}, 'canonical_url': {'type': 'string'}, 'source_status': {'enum': ['verified', 'published'], 'type': 'string'}}}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'url', 'checked_at'], 'properties': {'url': {'type': 'string'}, 'source': {'type': 'string'}, 'checked_at': {'type': 'string'}}}}}}

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

{'type': 'object', 'required': ['data', 'meta', 'evidence'], 'properties': {'data': {'type': 'object', 'required': ['accommodation', 'address', 'airport', 'airport_distance', 'booking_process', 'canonical_url', 'consultation_languages', 'entity_id', 'evidence', 'location', 'online_consultation', 'opening_hours', 'packages', 'stay_length', 'transfer'], 'properties': {'address': {'type': 'string'}, 'airport': {'type': 'string'}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['checked_at', 'source', 'url'], 'properties': {'url': {'type': 'string'}, 'source': {'type': 'string'}, 'checked_at': {'type': 'string'}}}}, 'location': {'type': 'string'}, 'packages': {'type': 'array', 'items': {'type': 'object', 'required': ['inclusions', 'note', 'package_name'], 'properties': {'note': {'type': 'string'}, 'inclusions': {'type': 'array', 'items': {'type': 'string'}}, 'package_name': {'type': 'string'}}}}, 'transfer': {'type': 'string'}, 'entity_id': {'type': 'string'}, 'stay_length': {'type': 'object', 'required': ['Comprehensive treatments (All-on-4, full smile makeover, multiple implants) â\x80\x94 initial visit', 'Follow-up visit for healing (where applicable)', 'Simple procedures (teeth whitening, single crown)'], 'properties': {'Follow-up visit for healing (where applicable)': {'type': 'string'}, 'Simple procedures (teeth whitening, single crown)': {'type': 'string'}, 'Comprehensive treatments (All-on-4, full smile makeover, multiple implants) â\x80\x94 initial visit': {'type': 'string'}}}, 'accommodation': {'type': 'string'}, 'canonical_url': {'type': 'string'}, 'opening_hours': {'type': 'string'}, 'booking_process': {'type': 'string'}, 'airport_distance': {'type': 'string'}, 'online_consultation': {'type': 'string'}, 'consultation_languages': {'type': 'array', 'items': {'type': 'string'}}}}, 'meta': {'type': 'object', 'required': ['entity_id', 'canonical_url', 'source_status'], 'properties': {'entity_id': {'type': 'string'}, 'last_updated': {'type': 'string'}, 'canonical_url': {'type': 'string'}, 'source_status': {'enum': ['verified', 'published'], 'type': 'string'}}}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'url', 'checked_at'], 'properties': {'url': {'type': 'string'}, 'source': {'type': 'string'}, 'checked_at': {'type': 'string'}}}}}}

{'type': 'object', 'properties': {'language': {'type': 'string', 'description': 'Language code (en, de, ar, tr, ru, fr, pl); defaults to en'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['data', 'meta', 'evidence'], 'properties': {'data': {'type': 'object', 'required': ['whatsapp_url'], 'properties': {'whatsapp_url': {'type': 'string'}}}, 'meta': {'type': 'object', 'required': ['entity_id', 'canonical_url', 'source_status'], 'properties': {'entity_id': {'type': 'string'}, 'last_updated': {'type': 'string'}, 'canonical_url': {'type': 'string'}, 'source_status': {'enum': ['verified', 'published'], 'type': 'string'}}}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'url', 'checked_at'], 'properties': {'url': {'type': 'string'}, 'source': {'type': 'string'}, 'checked_at': {'type': 'string'}}}}}}

{'type': 'object', 'required': ['name', 'consent'], 'properties': {'name': {'type': 'string', 'maxLength': 120, 'minLength': 2}, 'email': {'type': 'string', 'format': 'email', 'maxLength': 200}, 'phone': {'type': 'string', 'maxLength': 40}, 'consent': {'type': 'boolean', 'description': 'User confirms the clinic may contact them using these details.'}, 'preferred_language': {'enum': ['en', 'de', 'tr', 'ar', 'ru', 'fr', 'pl'], 'type': 'string', 'default': 'en'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['status', 'detail'], 'properties': {'detail': {'type': 'string'}, 'status': {'type': 'string'}, 'request_id': {'type': 'string'}}}

{'type': 'object', 'required': ['query'], 'properties': {'kind': {'enum': ['clinic', 'doctor', 'treatment', 'credential', 'service', 'policy'], 'type': 'string', 'description': 'Restrict results to one entity kind. Omit to search every kind.'}, 'query': {'type': 'string', 'description': 'Free-text search query in any of the seven site languages, e.g. "dental implant price", "implant fiyatı", "Zahnimplantat Preis", "Ñ\x86ена импланÑ\x82а"'}, 'top_k': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results to return (default 10, maximum 50). Results are ordered by relevance, so the first rows are the strongest matches. total_matches reports how many entities matched in total.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['data', 'meta', 'evidence'], 'properties': {'data': {'type': 'object', 'required': ['results', 'total_matches', 'returned', 'truncated'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url', 'entity_id', 'kind', 'name', 'canonical_url', 'summary'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'kind': {'type': 'string'}, 'name': {'type': 'string'}, 'title': {'type': 'string'}, 'summary': {'type': 'string'}, 'entity_id': {'type': 'string'}, 'canonical_url': {'type': 'string'}}}}, 'returned': {'type': 'integer'}, 'truncated': {'type': 'boolean', 'description': 'True when total_matches exceeded top_k and results were cut.'}, 'total_matches': {'type': 'integer', 'description': 'How many entities matched before top_k truncation.'}}}, 'meta': {'type': 'object', 'required': ['entity_id', 'canonical_url', 'source_status'], 'properties': {'entity_id': {'type': 'string'}, 'last_updated': {'type': 'string'}, 'canonical_url': {'type': 'string'}, 'source_status': {'enum': ['verified', 'published'], 'type': 'string'}}}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'url', 'checked_at'], 'properties': {'url': {'type': 'string'}, 'source': {'type': 'string'}, 'checked_at': {'type': 'string'}}}}}}