Skip to main content
Use this endpoint to fetch the full details of a practitioner by their ID. The response includes all stored fields: name, NPI, specialty, qualifications, languages, contact information, and address.

​
Request

GET https://api.clinikapi.com/v1/practitioners/{id}

​
Headers

​
x-api-key
string
required
Your ClinikAPI secret key (clk_live_* or clk_test_*).

​
Path Parameters

​
id
string
required
The practitioner ID to retrieve (e.g. prac_xyz789).

​
Response

Returns 200 OK with the practitioner resource.
​
data.id
string
The practitioner’s unique ID.
​
data.firstName
string
Practitioner’s first name.
​
data.lastName
string
Practitioner’s last name.
​
data.prefix
string[]
Name prefixes (e.g. ["Dr."]).
​
data.suffix
string[]
Name suffixes (e.g. ["MD", "FACC"]).
​
data.email
string
Practitioner’s email address.
​
data.phone
string
Practitioner’s phone number.
​
data.npi
string
National Provider Identifier.
​
data.specialty
string
Primary specialty.
​
data.qualifications
array
List of professional qualifications.
​
data.languages
string[]
BCP-47 language codes for languages spoken.
​
meta
object
Standard response metadata.

​
Examples

​
curl

curl https://api.clinikapi.com/v1/practitioners/prac_xyz789 \
  -H "x-api-key: clk_live_abc123"

​
TypeScript SDK

import { ClinikAPI } from "@clinikapi/sdk";

const client = new ClinikAPI({ apiKey: "clk_live_abc123" });

const practitioner = await client.practitioners.read("prac_xyz789");
console.log(practitioner.data.specialty); // "Cardiology"