Skip to main content
Use this endpoint to fetch a specific practitioner role by its ID. The response includes the full role record — the linked practitioner, organization, location, specialty, status, and any defined active period.

​
Request

GET https://api.clinikapi.com/v1/practitioner-roles/{id}

​
Headers

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

​
Path Parameters

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

​
Response

Returns 200 OK with the practitioner role resource.
​
data.id
string
The practitioner role’s unique ID.
​
data.practitionerId
string
ID of the linked practitioner.
​
data.role
string
Role code (e.g. doctor, nurse, consultant).
​
data.organizationId
string
Organization reference ID, if set.
​
data.locationId
string
Location reference ID, if set.
​
data.specialty
object
Specialty object with code and display fields.
​
data.status
string
Current role status: active or inactive.
​
data.period
object
Active date range with start and optional end fields.
​
meta
object
Standard response metadata including requestId, timestamp, status, and rate-limit fields.

​
Examples

​
curl

curl https://api.clinikapi.com/v1/practitioner-roles/pr_abc123 \
  -H "x-api-key: clk_live_abc123"

​
TypeScript SDK

import { Clinik } from '@clinikapi/sdk';

const clinik = new Clinik(process.env.CLINIKAPI_SECRET_KEY!);

const { data } = await clinik.practitionerRoles.read('pr_abc123');

console.log(data.role);           // "doctor"
console.log(data.specialty.display); // "Cardiology"