Skip to main content
Use this endpoint to fetch all details for a specific encounter by its ID. The response includes the encounter’s status, class, associated patient and practitioner, timing, diagnoses, and location.

​
Request

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

​
Headers

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

​
Path Parameters

​
id
string
required
The encounter ID to retrieve.

​
Response

Returns 200 OK with the encounter resource.
​
data.id
string
Encounter ID.
​
data.status
string
Encounter status (e.g. finished, in-progress).
​
data.class
string
Visit class code (e.g. AMB, IMP).
​
data.patientId
string
ID of the linked patient.
​
data.practitionerId
string
ID of the responsible practitioner.
​
data.period
object
Encounter period with start and end timestamps.
​
data.lengthMinutes
integer
Duration of the encounter in minutes.
​
data.location
string
Location of the encounter.
​
data.diagnosis
array
Diagnoses associated with the encounter.
​
meta
object
Standard response metadata.

​
Examples

​
curl

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

​
TypeScript SDK

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

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

const encounter = await client.encounters.read("enc_def456");
console.log(encounter.data.status); // "finished"