Skip to main content
Use this endpoint to fetch the full details of a specific appointment by ID. The response includes the appointment status, linked patient and practitioner, timing, service details, and any patient instructions.

​
Request

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

​
Headers

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

​
Path Parameters

​
id
string
required
The appointment ID to retrieve.

​
Response

Returns 200 OK with the appointment resource.
​
data.id
string
Appointment ID.
​
data.status
string
Current appointment status.
​
data.patientId
string
Patient ID.
​
data.practitionerId
string
Practitioner ID, if assigned.
​
data.start
string
Start time in ISO 8601 format.
​
data.end
string
End time in ISO 8601 format.
​
data.minutesDuration
integer
Duration in minutes.
​
data.serviceType
string
Service type.
​
data.patientInstruction
string
Patient preparation instructions.
​
meta
object
Standard response metadata.

​
Examples

​
curl

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

​
TypeScript SDK

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

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

const appt = await client.appointments.read("appt_jkl345");
console.log(appt.data.status); // "booked"