List a raptor’s health records
Returns one raptor’s health-care history (observations, treatments, vet visits, vaccinations, lab results, ...), most recent first. Capped at 200 rows by default (use `limit`).
bearerAuthAuthorizationBearer <token>A Clerk user API key or OAuth access token carrying the falconry:read and/or falconry:write scope.
raptorId*stringOpaque Convex document id.
length <= 64limit?integerCap the number of rows returned, most recent first. Default and max 200.
0 < value <= 200List a raptor’s health records
application/json- response
healthRecords*array<>curl -X GET 'https://app.falconryscale.com/api/v1/raptors/string/health-records'{
"healthRecords": [
{
"id": "string",
"raptorId": "string",
"recordType": "observation",
"recordDate": "string",
"symptom": "string",
"symptomSeverity": "mild",
"diagnosis": "string",
"treatment": "string",
"medicationName": "string",
"dosage": "string",
"frequency": "string",
"durationDays": 0,
"vetName": "string",
"vetClinic": "string",
"vetContact": "string",
"nextAppointmentDate": "string",
"resolutionDate": "string",
"outcome": "resolved",
"notes": "string",
"attachments": [
{
"fileName": "string",
"mimeType": "string",
"fileSizeBytes": 0
}
],
"loggedByName": "string"
}
]
}Stop the active bring-down plan
Stops the raptor's active bring-down plan (it is kept as an inactive schedule, not deleted). 404s if no plan is running.
Add a health record
Records a health event for a raptor: an observation, treatment, vet visit, vaccination, injury, illness, medication, lab result, parasite check or moult note. Fill only the fields that apply. Attachments must be added in the app. For an ongoing medication course with dose tracking, use create_medication instead.