Scheduling
Plan and manage duties for crew members — FTL limits are automatically validated.
Duty Object
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | integer | Optional | Unique duty ID |
| crew_member_id | integer | Pflicht | Crew member ID |
| flight_ids | array | Optional | IDs of associated flights |
| report_time_utc | datetime | Pflicht | Briefing / report-in time (UTC) |
| release_time_utc | datetime | Optional | Planned release time (UTC) |
| duty_type | enum | Pflicht | flight_duty | ground_duty | standby | positioning | rest |
| status | enum | Optional | planned | confirmed | active | completed | cancelled |
| duty_hours | number | Optional | Total duty duration in hours |
| block_hours | number | Optional | Flight hours in the duty |
| cumulative_duty_hours_7d | number | Optional | Cumulative duty hours (last 7 days) |
| cumulative_block_hours_28d | number | Optional | Cumulative block hours (last 28 days) |
FTL Limits Overview
| Limit | Value |
|---|---|
| Max. Duty Time | 13 h (extendable to 15 h with agreement) |
| Max. FDP | 13 h |
| Max. Block Hours / 7 days | 60 h |
| Max. Block Hours / 28 days | 100 h |
| Max. Block Hours / year | 900 h |
| Min. rest period between duties | 12 h |
| Max. sectors without extended recovery | no fixed limit — duty-time dependent |
GET /duties
GEThttps://api.aeroselect.io/api/v1/crewops/duties
cURLBash
curl "https://api.aeroselect.io/api/v1/crewops/duties?crew_member_id=201&date=2026-06-01" \
-H "X-API-Key: ak_live_YOUR_KEY"Response 200JSON
{
"data": [
{
"id": 1001,
"crew_member_id": 201,
"flight_ids": [5001, 5002],
"report_time_utc": "2026-06-01T05:30:00Z",
"release_time_utc": "2026-06-01T18:45:00Z",
"duty_type": "flight_duty",
"status": "confirmed",
"duty_hours": 13.25,
"block_hours": 9.5,
"cumulative_duty_hours_7d": 38.5,
"cumulative_block_hours_28d": 67.0
}
]
}POST /duties — Schedule a Duty
POSThttps://api.aeroselect.io/api/v1/crewops/duties
FTL Validation
The POST endpoint automatically validates all FTL limits. A violation returns HTTP 422 with a detailed error message.
cURLBash
curl -X POST "https://api.aeroselect.io/api/v1/crewops/duties" \
-H "X-API-Key: ak_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"crew_member_id": 201,
"flight_ids": [5010, 5011],
"report_time_utc": "2026-06-10T07:00:00Z",
"duty_type": "flight_duty"
}'PATCH /duties/{id}/status
PATCHhttps://api.aeroselect.io/api/v1/crewops/duties/{id}/status
cURLBash
curl -X PATCH "https://api.aeroselect.io/api/v1/crewops/duties/1001/status" \
-H "X-API-Key: ak_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "status": "completed" }'