Scheduling

Plan and manage duties for crew members — FTL limits are automatically validated.

Duty Object

FeldTypPflichtBeschreibung
idintegerOptionalUnique duty ID
crew_member_idintegerPflichtCrew member ID
flight_idsarrayOptionalIDs of associated flights
report_time_utcdatetimePflichtBriefing / report-in time (UTC)
release_time_utcdatetimeOptionalPlanned release time (UTC)
duty_typeenumPflichtflight_duty | ground_duty | standby | positioning | rest
statusenumOptionalplanned | confirmed | active | completed | cancelled
duty_hoursnumberOptionalTotal duty duration in hours
block_hoursnumberOptionalFlight hours in the duty
cumulative_duty_hours_7dnumberOptionalCumulative duty hours (last 7 days)
cumulative_block_hours_28dnumberOptionalCumulative block hours (last 28 days)

FTL Limits Overview

LimitValue
Max. Duty Time13 h (extendable to 15 h with agreement)
Max. FDP13 h
Max. Block Hours / 7 days60 h
Max. Block Hours / 28 days100 h
Max. Block Hours / year900 h
Min. rest period between duties12 h
Max. sectors without extended recoveryno 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" }'