Skip to main content
GET
/
api
/
v1
/
appointments
/
{id}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a \
  --header 'x-api-key: YOUR_API_KEY'

{
  "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "scheduled_at": "2026-05-15T10:30:00Z",
  "status": "scheduled",
  "test_method": "practitioner",
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": null,
  "profile": {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": null
  }
}
Retrieve a single blood draw appointment by its UUID, including the embedded patient profile. Use this endpoint to check appointment status, confirm scheduling details, or retrieve the associated profile data.
Requires the TEST_SESSIONS_VIEW or TEST_SESSIONS_SCHEDULE scope. Requests made with a key that lacks both scopes return 403 Forbidden.

​
Request

​
Path parameters

​
id
string
required
Unique identifier (UUID) of the appointment to retrieve.

​
Response

On success, the API returns 200 OK with the appointment and its embedded profile.
​
id
string
required
Unique appointment identifier (UUID).
​
profile_id
string
required
UUID of the profile this appointment belongs to.
​
location_id
string
UUID of the test location. null for home kit appointments.
​
scheduled_at
string
Scheduled appointment date and time in ISO 8601 format. May be null.
​
status
string
required
Current appointment status. One of scheduled, confirmed, completed, or cancelled.
​
test_method
string
Method used for the blood draw. One of practitioner or home. May be null.
​
created_at
string
required
ISO 8601 timestamp of when the appointment was created.
​
updated_at
string
ISO 8601 timestamp of the last update. May be null.
​
profile
object
required
The patient profile associated with this appointment.

​
Error responses

StatusDescription
400Invalid ID format — the provided value is not a valid UUID.
403Forbidden — missing TEST_SESSIONS_VIEW or TEST_SESSIONS_SCHEDULE scope.
404Appointment not found.
500Internal server error.
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a \
  --header 'x-api-key: YOUR_API_KEY'

{
  "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "scheduled_at": "2026-05-15T10:30:00Z",
  "status": "scheduled",
  "test_method": "practitioner",
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": null,
  "profile": {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": null
  }
}