{"components":{"schemas":{"Links":{"type":"object","properties":{"self":{"type":"string"},"documentation":{"type":"string"},"openapi":{"type":"string"},"methodology":{"type":"string"}},"required":["self","documentation","openapi","methodology"]},"Meta":{"type":"object","properties":{"total":{"type":"integer"},"offset":{"type":"integer"},"limit":{"type":"integer"},"snapshotDates":{"type":"object"}}},"Error":{"type":"object","properties":{"apiVersion":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"links":{"type":"object"}},"required":["apiVersion","error","links"]},"Source":{"type":"object","properties":{"source_record_id":{"type":"string"},"source_url":{"type":"string","format":"uri"},"retrieved_at":{"type":["string","null"]}},"required":["source_record_id","source_url","retrieved_at"]},"PracticeLocation":{"type":"object","properties":{"city":{"type":"string"},"locality_code":{"type":["string","null"]},"region":{"type":["string","null"]},"region_id":{"type":["string","null"]},"basis":{"const":"practice_locality_statement"},"observed_at":{"type":["string","null"]},"hospital_identity_verified":{"const":false},"ministry_identity_verified":{"const":false}},"required":["city","region","region_id","basis","observed_at","hospital_identity_verified","ministry_identity_verified"]},"CertifiedSpecialty":{"type":"object","properties":{"name":{"type":"string"},"certificate_number":{"type":["string","null"]},"specialty_registered_on":{"type":["string","null"]}},"required":["name","certificate_number","specialty_registered_on"]},"RegistryRecord":{"type":"object","properties":{"record_key":{"type":"string"},"name":{"type":"string"},"first_name":{"type":["string","null"]},"surname":{"type":["string","null"]},"licence_number":{"type":"string"},"licence_year":{"type":["integer","null"]},"licence_registered_on":{"type":["string","null"]},"registered_specialties":{"type":"array","items":{"type":"string"}},"specialty_registrations":{"type":"array","items":{"$ref":"#/components/schemas/CertifiedSpecialty"}},"identity_conflict":{"type":"boolean"},"current_practice_status":{"const":"unknown"},"profile_url":{"type":"string"}},"required":["record_key","name","first_name","surname","licence_number","licence_year","licence_registered_on","registered_specialties","specialty_registrations","identity_conflict","current_practice_status","profile_url"]},"Profile":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"display_name":{"type":"string"},"first_name":{"type":"null"},"surname":{"type":"null"},"title":{"type":["string","null"]},"profile_basis":{"enum":["hospital_published_profile","practice_directory_profile"]},"stated_expertise":{"type":"array","items":{"type":"string"}},"broader_categories":{"type":"array","items":{"type":"string"}},"licence_number":{"type":"null"},"licence_year":{"type":"null"},"certified_specialties":{"type":"null"},"role":{"type":["string","null"]},"hospital":{"type":["string","null"]},"department":{"type":["string","null"]},"source":{"anyOf":[{"$ref":"#/components/schemas/Source"},{"type":"null"}]},"source_observed_at":{"type":["string","null"]},"practice_locations":{"type":"array","items":{"$ref":"#/components/schemas/PracticeLocation"}},"practice_location_candidates":{"type":"array","items":{"$ref":"#/components/schemas/PracticeLocation"}},"licence_link_status":{"type":"string"},"employment_currently_verified":{"const":false}},"required":["id","url","display_name","profile_basis","stated_expertise","licence_number","licence_year","certified_specialties","practice_locations","practice_location_candidates"]},"SearchHit":{"type":"object","properties":{"id":{"type":"string"},"record_type":{"enum":["registry","source_profile","editorial","specialty"]},"title":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"},"json_url":{"type":"string"},"markdown_url":{"type":"string"},"snapshot_date":{"type":"string"},"identity_verified":{"const":false}},"required":["id","record_type","title","description","url","json_url","markdown_url","snapshot_date","identity_verified"]},"SearchResults":{"type":"object","properties":{"total":{"type":"integer"},"offset":{"type":"integer"},"limit":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/SearchHit"}},"count_unit":{"type":"string"},"ordering":{"type":"string"}},"required":["total","offset","limit","results","count_unit","ordering"]},"FetchResult":{"type":"object","properties":{"id":{"type":"string"},"record_type":{"type":"string"},"url":{"type":"string"},"title":{"type":"string"},"snapshot_date":{"type":"string"},"data":{"anyOf":[{"$ref":"#/components/schemas/RegistryRecord"},{"type":"object","properties":{"profile":{"$ref":"#/components/schemas/Profile"},"identity_policy":{"type":"string"}},"required":["profile","identity_policy"]},{"$ref":"#/components/schemas/EditorialProfile"},{"type":"object"}]}},"required":["id","record_type","url","title","snapshot_date","data"]},"EditorialProfile":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"focus":{"type":"array","items":{"type":"string"}},"role":{"type":"string"},"institution":{"type":"string"},"url":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"label":{"type":"string"},"accessed_at":{"type":"string"}}}},"clinical_quality_score":{"type":"null"},"editorial_score":{"type":"number"},"editorial_scoring":{"type":"object"}},"required":["id","name","category","focus","role","institution","clinical_quality_score"]},"FindResults":{"type":"object","properties":{"total":{"type":"integer"},"offset":{"type":"integer"},"limit":{"type":"integer"},"record_type":{"type":"string"},"results":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/RegistryRecord"},{"type":"object","properties":{"id":{"type":"string"},"record_type":{"type":"string"},"profile":{"$ref":"#/components/schemas/Profile"},"matched_practice":{"type":"object"},"url":{"type":"string"}},"required":["id","record_type","profile","matched_practice","url"]}]}},"notice":{"type":"string"}},"required":["total","offset","limit","results","notice"]},"Recommendations":{"type":"object","properties":{"total":{"type":"integer"},"offset":{"type":"integer"},"limit":{"type":"integer"},"editorial":{"type":"array","items":{"$ref":"#/components/schemas/EditorialProfile"}},"matches":{"$ref":"#/components/schemas/FindResults"},"clinical_quality_score":{"type":"null"},"methodology_version":{"type":"string"},"notice":{"type":"string"}},"required":["editorial","clinical_quality_score","notice"]},"Comparison":{"type":"object","properties":{"records":{"type":"array","items":{"$ref":"#/components/schemas/FetchResult"}},"clinical_quality_score":{"type":"null"},"notice":{"type":"string"}},"required":["records","clinical_quality_score","notice"]},"SpecialtyCatalog":{"type":"object","properties":{"practice":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"count":{"type":"integer"},"assignment_basis":{"type":"string"},"certification_verified":{"const":false}},"required":["name","count","assignment_basis","certification_verified"]}},"listed_directory":{"type":"array","items":{"type":"object"}},"certified":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"record_count":{"type":"integer"}},"required":["name","record_count"]}},"editorial":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"}},"required":["id","name","url"]}},"aliases":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"he":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}}},"required":["id","he","aliases"]}},"notice":{"type":"string"}},"required":["practice","listed_directory","certified","editorial","aliases","notice"]},"CityCatalog":{"type":"object","properties":{"cities":{"type":"array","items":{"type":"object","properties":{"city":{"type":"string"},"locality_code":{"type":["string","null"]},"region":{"type":["string","null"]},"region_id":{"type":["string","null"]},"count":{"type":"integer"}},"required":["city","region","region_id","count"]}},"areas":{"type":"array","items":{"type":"object"}},"hospitals":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"count":{"type":"integer"}},"required":["name","count"]}},"notice":{"type":"string"}},"required":["cities","areas","hospitals","notice"]},"LegacyResponse":{"type":"object","description":"Compatibility endpoint. Prefer the typed v2 discovery/search/fetch/find interfaces.","additionalProperties":true}}},"openapi":"3.1.0","info":{"title":"Israel Physician Index","version":"2.0.0","description":"Free public read-only API. No account or API key required. Versioning and deprecation policy: /api-policy.md. Complete supplied Ministry snapshot dated 2026-09-24, not live. Evidence coverage is not clinical quality. Practice city filtering is available for partial coverage; six editorial city-based area filters are available, with explicit mappings at /api/v1/regions. Hospital affiliation is not clinic geography. See /api/v1/data-catalog and /llms-full.txt."},"externalDocs":{"description":"Agent manual and evidence rules","url":"https://www.opendata.co.il/llms-full.txt"},"servers":[{"url":"/"}],"security":[],"paths":{"/api/v1/regions":{"get":{"operationId":"regions","summary":"Six editorial practice-city areas, explicit city mappings and deduplicated record counts","parameters":[],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/data-catalog":{"get":{"operationId":"data_catalog","summary":"Dataset coverage, snapshot dates, completeness, access, refresh and clinic geography policy","parameters":[],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/directory":{"get":{"operationId":"directory","summary":"Search candidate source groups from seven hospitals and practice profiles; identity unverified","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"hospital","in":"query","required":false,"schema":{"type":"string"}},{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"city","in":"query","description":"Published practice locality or supplied locality code. Never hospital location. With category, match practice-derived tags only.","schema":{"type":"string","maxLength":120}},{"name":"region","in":"query","description":"Editorial area ID or Hebrew name. City and area must match the same practice locality; not an official district.","schema":{"type":"string","enum":["north","south","jerusalem","center","sharon","tel-aviv","צפון","דרום","ירושלים","מרכז","שרון","תל אביב"]}},{"name":"grade","in":"query","schema":{"type":"string","enum":["strong","probable","resolved","unresolved"]}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/directory/metadata":{"get":{"operationId":"directory_metadata","summary":"Covered hospitals, published practice localities and inferred search categories; not certificates","parameters":[],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/hospitals/sheba/doctors":{"get":{"operationId":"hospitals_sheba_doctors","summary":"Search hospital-published role, specialty and department; cross-source identity links unverified","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"specialty","in":"query","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/specialties":{"get":{"operationId":"specialties","summary":"List editions and coverage","parameters":[],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/doctors":{"get":{"operationId":"doctors","summary":"Search editorial profiles; coverage is not clinical quality","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"focus","in":"query","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/expertise":{"get":{"operationId":"expertise","summary":"List medical expertise categories; category membership is not licence verification","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"basis","in":"query","schema":{"type":"string","enum":["listed","inferred","any"],"default":"listed"}}],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/expertise/doctors":{"get":{"operationId":"expertise_doctors","summary":"Search broad expertise directory; inferred memberships are opt-in, not a ranking","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"basis","in":"query","schema":{"type":"string","enum":["listed","inferred","any"],"default":"listed"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/registry":{"get":{"operationId":"registry","summary":"Search supplied register; current status unknown","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/registry/specialties":{"get":{"operationId":"registry_specialties","summary":"List official registered specialty names and counts","parameters":[],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/registry/check-specialty":{"get":{"operationId":"registry_check_specialty","summary":"Check a matched registry record for a registered specialty; preserve ambiguous identities","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"specialty","in":"query","required":true,"schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/intents":{"get":{"operationId":"intents","summary":"Map common Hebrew doctor search questions to routes and tools","parameters":[],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/registry-metadata":{"get":{"operationId":"registry_metadata","summary":"Register provenance and counts","parameters":[],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/methodology":{"get":{"operationId":"methodology","summary":"Selection rules and limitations","parameters":[],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/sources":{"get":{"operationId":"sources","summary":"Source catalogue","parameters":[],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/candidates":{"get":{"operationId":"candidates","summary":"Discovery ledger, not clinical assessments","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"JSON response with source provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegacyResponse"}}}},"400":{"description":"Invalid query"}}}},"/api/v1/doctors/{id}":{"get":{"operationId":"get_doctor","summary":"Get an editorial profile by stable ID or slug","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Profile with sources and limitations"},"404":{"description":"Unknown profile"}}}},"/api/v1/expertise/doctors/{id}":{"get":{"operationId":"get_directory_doctor","summary":"Directory record plus unverified exact-name registry candidates, certificates/dates and overlap; never an automatic identity merge","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Directory record; all memberships explicitly marked listed or inferred"},"404":{"description":"Unknown directory ID"}}}},"/api/v1/hospitals/sheba/doctors/{id}":{"get":{"operationId":"get_hospital_doctor","summary":"Get a Sheba hospital record with source claims and candidate cross-references","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Hospital record; candidate identity links remain unverified"},"404":{"description":"Unknown hospital ID"}}}},"/api/v1/directory/{id}":{"get":{"operationId":"get_enriched_doctor","summary":"Source group with hospital evidence and separately labelled unverified Ministry candidate","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Candidate source group; not independently verified identity"},"404":{"description":"Unknown entry ID"}}}},"/api/v1/registry/{id}":{"get":{"operationId":"get_registry_record","summary":"Source-separated given name and surname, licence year and certificates for one exact Ministry record group","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Official snapshot record; does not verify links to hospital profiles"},"404":{"description":"Unknown record key"}}}},"/api/v1/search":{"get":{"operationId":"search","summary":"Unified search across separate record layers","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"type","in":"query","required":false,"schema":{"enum":["all","registry","profile","editorial","specialty"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":10000}}],"responses":{"200":{"description":"Dated record data","content":{"application/json":{"schema":{"type":"object","properties":{"apiVersion":{"type":"string"},"documentationUpdated":{"type":"string"},"data":{"$ref":"#/components/schemas/SearchResults"},"links":{"$ref":"#/components/schemas/Links"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["apiVersion","documentationUpdated","data","links","meta"]}}}},"400":{"description":"Invalid filters or unverified cross-source join","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/fetch":{"get":{"operationId":"fetch","summary":"Retrieve one stable, namespaced record ID","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","maxLength":240}}],"responses":{"200":{"description":"Dated record data","content":{"application/json":{"schema":{"type":"object","properties":{"apiVersion":{"type":"string"},"documentationUpdated":{"type":"string"},"data":{"$ref":"#/components/schemas/FetchResult"},"links":{"$ref":"#/components/schemas/Links"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["apiVersion","documentationUpdated","data","links","meta"]}}}},"400":{"description":"Invalid filters or unverified cross-source join","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/find":{"get":{"operationId":"find","summary":"Filter profiles; certified_only uses official records and rejects geography/hospital joins","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"specialty","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"city","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"region","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"hospital","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"certified_only","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":100000,"default":0}}],"responses":{"200":{"description":"Dated record data","content":{"application/json":{"schema":{"type":"object","properties":{"apiVersion":{"type":"string"},"documentationUpdated":{"type":"string"},"data":{"$ref":"#/components/schemas/FindResults"},"links":{"$ref":"#/components/schemas/Links"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["apiVersion","documentationUpdated","data","links","meta"]}}}},"400":{"description":"Invalid filters or unverified cross-source join","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/recommendations":{"get":{"operationId":"recommendations","summary":"Editorial selections; geographic matches are returned separately","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"specialty","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"city","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"region","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"hospital","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"certified_only","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":100000,"default":0}}],"responses":{"200":{"description":"Dated record data","content":{"application/json":{"schema":{"type":"object","properties":{"apiVersion":{"type":"string"},"documentationUpdated":{"type":"string"},"data":{"$ref":"#/components/schemas/Recommendations"},"links":{"$ref":"#/components/schemas/Links"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["apiVersion","documentationUpdated","data","links","meta"]}}}},"400":{"description":"Invalid filters or unverified cross-source join","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/compare":{"get":{"operationId":"compare","summary":"Compare 2–4 distinct record IDs, no clinical winner","parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated namespaced record IDs"}}],"responses":{"200":{"description":"Dated record data","content":{"application/json":{"schema":{"type":"object","properties":{"apiVersion":{"type":"string"},"documentationUpdated":{"type":"string"},"data":{"$ref":"#/components/schemas/Comparison"},"links":{"$ref":"#/components/schemas/Links"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["apiVersion","documentationUpdated","data","links","meta"]}}}},"400":{"description":"Invalid filters or unverified cross-source join","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/specialty-catalog":{"get":{"operationId":"specialty_catalog","summary":"Separate practice, certified, listed and editorial taxonomies","parameters":[],"responses":{"200":{"description":"Dated record data","content":{"application/json":{"schema":{"type":"object","properties":{"apiVersion":{"type":"string"},"documentationUpdated":{"type":"string"},"data":{"$ref":"#/components/schemas/SpecialtyCatalog"},"links":{"$ref":"#/components/schemas/Links"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["apiVersion","documentationUpdated","data","links","meta"]}}}},"400":{"description":"Invalid filters or unverified cross-source join","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/city-catalog":{"get":{"operationId":"city_catalog","summary":"Clinic cities, editorial areas and hospital labels","parameters":[],"responses":{"200":{"description":"Dated record data","content":{"application/json":{"schema":{"type":"object","properties":{"apiVersion":{"type":"string"},"documentationUpdated":{"type":"string"},"data":{"$ref":"#/components/schemas/CityCatalog"},"links":{"$ref":"#/components/schemas/Links"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["apiVersion","documentationUpdated","data","links","meta"]}}}},"400":{"description":"Invalid filters or unverified cross-source join","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/registry/browse":{"get":{"operationId":"registry_browse","summary":"Paginated browse of the official snapshot","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"specialty","in":"query","required":false,"schema":{"type":"string"}},{"name":"certified_only","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":100000,"default":0}}],"responses":{"200":{"description":"Dated record data","content":{"application/json":{"schema":{"type":"object","properties":{"apiVersion":{"type":"string"},"documentationUpdated":{"type":"string"},"data":{"$ref":"#/components/schemas/FindResults"},"links":{"$ref":"#/components/schemas/Links"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["apiVersion","documentationUpdated","data","links","meta"]}}}},"400":{"description":"Invalid filters or unverified cross-source join","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}