careMESH NPD
0.1.0 - ci-build United States of America flag

careMESH NPD - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

OperationDefinition: Find Practitioner / HealthcareService / Organization

Official URL: http://fhir.caremesh.app/OperationDefinition/CaremeshResourceFind Version: 0.1.0
Active as of 2025-09-24 Computable Name: careMESH Find $find

FHIR Operation to search for Practitioners, HealthcareServices, or Organizations.

General:

  • This operation may be invoked on the Practitioner, HealthcareService, or Organization resource types (see examples below).
  • Different resource types accept different subsets of the query parameters described below.

Resource-specific notes and examples:

  • Practitioner: supports given, family, middle, suffix, address components, telecom, phone, email, specialty, identifier. Example: GET /4_0_0/Practitioner/$find?given=Jane&family=Doe&specialty=207R00000X&specialty=207KA0200X

  • HealthcareService: uses name instead of given/family, does not use middle or suffix; supports address components, telecom, phone, email, specialty, identifier. Example: GET /4_0_0/HealthcareService/$find?name=Mount+Sinai&specialty=207R00000X

  • Organization: uses name only; supports address components, telecom, phone, email, identifier; does NOT support specialty. Example: GET /4_0_0/Organization/$find?name=Lenox+Hill&telecom=2124342000

Notes:

  • Multiple values for a parameter are provided by repeating the query parameter (e.g., specialty=207R00000X&specialty=207KA0200X).
  • Resource search is done using identifier, name, and address information. Additionally information is used to further match and improve scoring.

Generated Narrative: OperationDefinition CaremeshResourceFind

URL: [base]/Practitioner/$find

URL: [base]/HealthcareService/$find

URL: [base]/Organization/$find

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INidentifier0..*string

Unique identifiers of the resource (applicable to Practitioner, HealthcareService, Organization).

INname0..1string

Name of the HealthcareService or Organization. Not used for Practitioner (use given/family instead).

INgiven0..1string

First (given) name of the Practitioner. Applicable to Practitioner only.

INfamily0..1string

Last (family) name of the Practitioner. Applicable to Practitioner only.

INmiddle0..1string

Middle name or initial of the Practitioner. Applicable to Practitioner only.

INsuffix0..1string

Name suffix (e.g., MD, DR) for the Practitioner. Applicable to Practitioner only.

INaddress-city0..1string

City component of the resource's address (Practitioner, HealthcareService, Organization).

INaddress-state0..1string

State component of the resource's address (Practitioner, HealthcareService, Organization).

INaddress-zip0..1string

Postal code (ZIP) component of the resource's address (Practitioner, HealthcareService, Organization).

INaddress-line0..*string

Street line(s) of the resource's address (Practitioner, HealthcareService, Organization).

INtelecom0..*string

Telecom entries (e.g., phone number, direct address, email) for the resource.

INphone0..*string

Phone numbers for the resource.

INemail0..*string

Email addresses for the resource.

INspecialty0..*string

Practitioner or HealthcareService specialties. Not applicable to Organization.