--- title: 'Practitioner (FHIR R4)' description: 'A person who is directly or indirectly involved in providing healthcare. Read-only in the public API — practitioner reco' nav: 'API / R4 / Practitioner' order: 120 version: v1 fhir: r4 source: generated updated: '2026-09-23' --- # Practitioner (FHIR R4) A person who is directly or indirectly involved in providing healthcare. Read-only in the public API — practitioner records are managed through HuliPractice. Referenced by Appointment and Encounter resources. > This reference is generated from the canonical Huli Public API OpenAPI specification and the server's FHIR R4 CapabilityStatement — do not edit it directly. ## FHIR R4 Specification Official spec: [Practitioner — HL7 FHIR R4](https://hl7.org/fhir/R4/practitioner.html) ## Supported Interactions - **read** — Read a single resource by ID (`GET /fhir/R4/{Resource}/{id}`) - **search-type** — Search resources with query parameters (`GET /fhir/R4/{Resource}?...`) ## Scopes Scopes are shared across FHIR releases — the same `system/Practitioner.*` scope grants Practitioner access on both `/fhir/R4` and `/fhir/R5`. - — see [scope reference](/v1/scopes#system-practitioner-rs) ## Search Parameters | Parameter | Type | Notes | |-----------|------|-------| | `name` | string | Case-insensitive partial match. | | `_count` | number | Integer. For `_count`: default 20, max 100. | | `_offset` | number | Integer. For `_count`: default 20, max 100. | ## Endpoints ### Read Practitioner Retrieve a single Practitioner resource by its ID. This is a read-only resource. **Required scope:** #### Response — 200 ```json { "resourceType": "Practitioner", "id": "880e8400-e29b-41d4-a716-446655440020", "active": true, "name": [ { "use": "official", "family": "Rodriguez", "given": [ "Elena" ], "prefix": [ "Dr." ] } ], "telecom": [ { "system": "email", "value": "elena.rodriguez@clinic.example.com" } ], "qualification": [ { "code": { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/v2-0360", "code": "MD", "display": "Doctor of Medicine" } ] } } ] } ``` #### Code Samples :::CodeGroup ```bash {label="cURL"} TOKEN=$(curl -s -X POST https://api.huli.ai/auth/token \ -d "grant_type=client_credentials" \ -d "client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer" \ -d "client_assertion=${CLIENT_ASSERTION}" \ -d "scope=system/Practitioner.rs" \ | jq -r .access_token) curl -X GET https://api.huli.ai/fhir/R4/Practitioner/${RESOURCE_ID} \ -H "Authorization: Bearer ${TOKEN}" ``` ```typescript {label="TypeScript"} const token = process.env.HULI_ACCESS_TOKEN ?? ""; const response = await fetch( `https://api.huli.ai/fhir/R4/Practitioner/${id}`, { method: "GET", headers: { "Authorization": `Bearer ${token}`, }, } ); if (!response.ok) throw new Error(`HTTP ${String(response.status)}`); const data: unknown = await response.json(); ``` ```python {label="Python"} import os import requests token = os.environ["HULI_ACCESS_TOKEN"] headers = {"Authorization": f"Bearer {token}"} resp = requests.get( f"https://api.huli.ai/fhir/R4/Practitioner/{resource_id}", headers=headers, ) resp.raise_for_status() print(resp.json()) ``` ```java {label="Java"} import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class getPractitionerExample { public static void main(String[] args) throws Exception { String token = System.getenv("HULI_ACCESS_TOKEN"); String resourceId = "RESOURCE_ID"; HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.huli.ai/fhir/R4/Practitioner/" + resourceId)) .header("Authorization", "Bearer " + token) .header("Accept", "application/fhir+json") .method("GET", HttpRequest.BodyPublishers.noBody()) .build(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println("status: " + response.statusCode()); System.out.println(response.body()); } } ``` ```go {label="Go"} import ( "fmt" "net/http" "os" ) func getPractitionerExample() { token := os.Getenv("HULI_ACCESS_TOKEN") req, _ := http.NewRequest("GET", "https://api.huli.ai/fhir/R4/Practitioner/"+resourceID+"", nil) req.Header.Set("Authorization", "Bearer "+token) resp, err := http.DefaultClient.Do(req) if err != nil { fmt.Println("error:", err) return } defer resp.Body.Close() fmt.Println("status:", resp.Status) } ``` ::: #### Errors | Code | Status | Description | |------|--------|-------------| | [HPB-00106](/v1/errors#hpb-00106) | 401 | Authentication failed | | [HPB-00104](/v1/errors#hpb-00104) | 403 | Insufficient scope | | [HPB-00102](/v1/errors#hpb-00102) | 404 | Resource not found | | [HPB-00105](/v1/errors#hpb-00105) | 429 | Rate limit exceeded | --- ### Search Practitioner Search Practitioner resources. Results are returned as a FHIR searchset Bundle. This is a read-only discovery resource, gated by `system/Practitioner.rs`. **Required scope:** #### Query Parameters #### Response — 200 ```json { "resourceType": "Bundle", "type": "searchset", "total": 1, "entry": [ { "fullUrl": "Practitioner/880e8400-e29b-41d4-a716-446655440020", "resource": { "resourceType": "Practitioner", "id": "880e8400-e29b-41d4-a716-446655440020", "active": true, "name": [ { "use": "official", "text": "Dra. Elena Rodriguez" } ] }, "search": { "mode": "match" } } ] } ``` #### Code Samples :::CodeGroup ```bash {label="cURL"} TOKEN=$(curl -s -X POST https://api.huli.ai/auth/token \ -d "grant_type=client_credentials" \ -d "client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer" \ -d "client_assertion=${CLIENT_ASSERTION}" \ -d "scope=system/Practitioner.rs" \ | jq -r .access_token) curl -X GET https://api.huli.ai/fhir/R4/Practitioner \ -H "Authorization: Bearer ${TOKEN}" ``` ```typescript {label="TypeScript"} const token = process.env.HULI_ACCESS_TOKEN ?? ""; const response = await fetch( `https://api.huli.ai/fhir/R4/Practitioner`, { method: "GET", headers: { "Authorization": `Bearer ${token}`, }, } ); if (!response.ok) throw new Error(`HTTP ${String(response.status)}`); const data: unknown = await response.json(); ``` ```python {label="Python"} import os import requests token = os.environ["HULI_ACCESS_TOKEN"] headers = {"Authorization": f"Bearer {token}"} resp = requests.get( f"https://api.huli.ai/fhir/R4/Practitioner", headers=headers, ) resp.raise_for_status() print(resp.json()) ``` ```java {label="Java"} import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class searchPractitionerExample { public static void main(String[] args) throws Exception { String token = System.getenv("HULI_ACCESS_TOKEN"); HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.huli.ai/fhir/R4/Practitioner")) .header("Authorization", "Bearer " + token) .header("Accept", "application/fhir+json") .method("GET", HttpRequest.BodyPublishers.noBody()) .build(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println("status: " + response.statusCode()); System.out.println(response.body()); } } ``` ```go {label="Go"} import ( "fmt" "net/http" "os" ) func searchPractitionerExample() { token := os.Getenv("HULI_ACCESS_TOKEN") req, _ := http.NewRequest("GET", "https://api.huli.ai/fhir/R4/Practitioner", nil) req.Header.Set("Authorization", "Bearer "+token) resp, err := http.DefaultClient.Do(req) if err != nil { fmt.Println("error:", err) return } defer resp.Body.Close() fmt.Println("status:", resp.Status) } ``` ::: #### Errors | Code | Status | Description | |------|--------|-------------| | [HPB-00106](/v1/errors#hpb-00106) | 401 | Authentication failed | | [HPB-00104](/v1/errors#hpb-00104) | 403 | Insufficient scope | | [HPB-00105](/v1/errors#hpb-00105) | 429 | Rate limit exceeded | ---