Providers
FHIR PractitionerFHIR R4 Practitioner resources representing clinicians, specialists, and care team members.
The Provider Object
| Field | Type | Description |
|---|---|---|
| id | string | FHIR logical ID for the Practitioner resource |
| resourceType | string | Always "Practitioner" per FHIR R4 spec |
| name | HumanName[] | Array of FHIR HumanName objects (family, given, prefix) |
| identifier | Identifier[] | NPI and other professional identifiers |
| qualification | object[] | Credentials and licensure: MD, NP, RN, etc. |
| telecom | ContactPoint[] | Office phone, fax, and email contact points |
| address | Address[] | Practice location addresses |
Endpoints
Search FHIR Practitioner resources.
Parameters
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| specialtye.g. cardiology | query | string | optional | Clinical specialty code |
| npie.g. 1234567890 | query | string | optional | National Provider Identifier |
Request
curl "https://api.healthcloud.ai/v1/providers?specialty=cardiology" \ -H "Authorization: Bearer hc_test_sk_demo_live_xxxxxx"
Response
Response200
{ "resourceType": "Bundle", "type": "searchset", "total": 88, "entry": [ { "resource": { "resourceType": "Practitioner", "id": "prov_chen_001", "name": [{ "family": "Chen", "given": ["Sarah"] }], "identifier": [{ "system": "http://hl7.org/fhir/sid/us-npi", "value": "1234567890" }], "qualification": [{ "code": { "coding": [{ "code": "MD" }] } }] } } ] }