Get a raptor’s active bring-down plan
Returns the raptor's active bring-down plan (bringing the bird from its start weight down to its ready weight safely, at most 1.5% a day): today's day number, the total days, and the target weight for every day, in grams. `plan` is null when none is running.
bearerAuthAuthorizationBearer <token>A Clerk user API key or OAuth access token carrying the falconry:read and/or falconry:write scope.
raptorId*stringA raptor's id, from list_raptors.
length <= 64Get a raptor’s active bring-down plan
application/json- response
plan*|nullcurl -X GET 'https://app.falconryscale.com/api/v1/raptors/string/bring-down-plan'{
"plan": {
"scheduleId": "string",
"startWeightGrams": 0,
"startDate": "string",
"targetWeightGrams": 0,
"dayNumber": -9007199254740991,
"totalDays": -9007199254740991,
"dailyTargets": [
{
"day": -9007199254740991,
"date": "string",
"targetWeightGrams": 0
}
]
}
}List a raptor’s feeding schedules
Returns a raptor's feeding schedules, oldest first: target weight, daily feed slots, whether it is a moult schedule, and any bring-down plan parameters. For the day-by-day bring-down targets, use get_bring_down_plan.
Start a bring-down plan
Starts a bring-down plan for a raptor, the same as the app's Feeding plan screen: from its latest weigh-in down to its ready weight unless you pass other weights, over the safe minimum number of days. Fails with 409 if a plan is already running, and with 400 if there is no weigh-in or ready weight to default to. Returns the new plan's daily targets.