Provider Directory API
Use Cases
The Provider Directory enables you to find a network or organization. This section describes the use cases and search expectations for the Provider Directory.
-
Search for a practitioner by demographics (e.g., name, specialty).
Examples:
GET https://opala.tech/provdir/premera/v1/fhir-r4/Practitioner?name=smith
GET https://opala.tech/provdir/premera/v1/fhir-r4/Practitioner?specialty=cardiology -
Search for an organization or specialty within a region (e.g., city, state, distance from location). Or search for every organization with a specific specialty within a region.
Examples:
GET https://opala.tech/provdir/premera/v1/fhir-r4/Organization?address-postalcode=98101
GET https://opala.tech/provdir/premera/v1/fhir-r4/Organization?address-city=seattle&specialty=denti… -
Search for an organization and facility.
Examples:
GET https://opala.tech/provdir/premera/v1/fhir-r4/Location?organization=12345
GET https://opala.tech/provdir/premera/v1/fhir-r4/Organization?name=Evergreen+Medical+Center -
Search for a practitioner by organizational relationship (e.g., a practitioner in a specific health organization, a practitioner in a specific clinic).
Examples:
GET https://opala.tech/provdir/premera/v1/fhir-r4/PractitionerRole?organization=12345
GET https://opala.tech/provdir/premera/v1/fhir-r4/PractitionerRole?organization=12345&specialty=car…
Note: When searching for a practitioner by region using a postal code, Opala recommends you do not use the zip+4 format. Including the +4 suffix limits the results to a very specific area and is much less useful for finding a practitioner within a postal code area.