Confirm Blood Draw

POST

api

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
}

{
  "error": "barcode must be a numeric string"
}

{
  "error": "Appointment not found"
}

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.

Request

Path parameters

string

required

Unique identifier (UUID) of the appointment to confirm.

Body parameters

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.

boolean

true when the blood draw has been recorded and the lab order pipeline triggered.

Error responses

Status	Description
`400`	Validation error — e.g., `barcode` is missing or has an invalid format.
`403`	Forbidden — your API key does not have access to this operation.
`404`	Appointment not found.
`500`	Internal 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
}

{
  "error": "barcode must be a numeric string"
}

{
  "error": "Appointment not found"
}

Preview Containers

Get Lab Results

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
}

{
  "error": "barcode must be a numeric string"
}

{
  "error": "Appointment not found"
}

Health

Profiles

Appointments

Home Kit Orders

Biomarkers

Panels

Units

Locations

Documents

Shipments

Confirm Blood Draw

Request

Path parameters

Body parameters

Response

Error responses

​Request

​Path parameters

​Body parameters

​Response

​Error responses

Request

Path parameters

Body parameters

Response

Error responses