Skip to main content
POST
/
api
/
v1
/
appointments
/
{id}
/
confirm
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/confirm \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "barcode": "4012345678901"
  }'
{
  "success": true
}
Record that a blood draw has been completed and trigger the lab order pipeline. Submit the numeric barcode from the blood draw kit to link the physical sample to the appointment.
This action is irreversible. Once you confirm the blood draw, the appointment is locked — no further modifications, including adding panels, are possible.
Requires the TEST_SESSIONS_SCHEDULE scope. Requests made with a key that lacks this scope return 403 Forbidden.

Request

Path parameters

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

Body parameters

barcode
string
required
Numeric barcode string printed on the blood draw kit. Used to associate the physical sample with this appointment.

Response

On success, the API returns 200 OK confirming the lab order pipeline has been triggered.
success
boolean
true when the blood draw has been recorded and the lab order pipeline triggered.

Error responses

StatusDescription
400Validation error — e.g., barcode is missing or has an invalid format.
403Forbidden — missing TEST_SESSIONS_SCHEDULE scope.
404Appointment not found.
500Internal server error.
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/confirm \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "barcode": "4012345678901"
  }'
{
  "success": true
}