Skip to main content
GET
Get an appointment request
Returns one appointment request by the appointmentRequestId from List Appointment Requests. Its status moves to completed when the state grants the appointment. To hear about each change instead of polling, subscribe to the Appointment Request Status Change webhook. If you poll, pending, submitting and submitted are in progress; every other status is final, so stop polling once the request reaches one. completedAt is usually set on completion, but status is the signal to rely on. An id that does not exist, belongs to another organization, or names a termination request returns 404. A request cancelled while pending, in the Turris dashboard or with Cancel an Appointment Request, is kept and returns 200 with status canceled. It also carries canceledAt, when it was cancelled, and canceledBy, whose type says who cancelled it. Requests cancelled before Turris started recording this have neither. The response has the same fields as one row of the list. See that page for the statuses and what each field means.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

appointmentRequestId
string
required

Appointment request ID, as returned by the List Appointment Requests endpoint

Example:

"6672b1c2d3e4f5a6b7c8d9e0"

Response

The appointment request

data
object
required
requestId
string
required

Unique request identifier

Example:

"dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8"

timestamp
string
required

Response timestamp

Example:

"2025-11-12T20:49:03.293Z"