Availability

Retrieve and update crew member availability — FTL-compliant.

FTL Basics (EASA ORO.FTL)

LimitEASA value
Max. Duty Time13 hours (extendable to 15h)
Max. Flight Duty Period13 hours
Min. rest period12 hours
Max. Block Hours/year900 hours
Max. Block Hours/28 days100 hours
Max. Block Hours/7 days60 hours

Availability Object

FeldTypPflichtBeschreibung
idintegerOptionalUnique entry ID
crew_member_idintegerOptionalCrew member ID
fromdatePflichtPeriod start date
todatePflichtPeriod end date
typeenumPflichtavailable | unavailable | annual_leave | sick_leave | standby | training
notestring|nullOptionalOptional note
approved_bystring|nullOptionalApprover name/ID

GET /crew/{id}/availability

GEThttps://api.aeroselect.io/api/v1/crew/crew/{id}/availability
cURLBash
curl "https://api.aeroselect.io/api/v1/crew/crew/201/availability?from=2026-06-01&to=2026-06-30" \
  -H "X-API-Key: ak_live_YOUR_KEY"
Response 200JSON
{
  "data": [
    {
      "id": 601,
      "crew_member_id": 201,
      "from": "2026-06-15",
      "to": "2026-06-22",
      "type": "annual_leave",
      "note": "Approved annual leave",
      "approved_by": "[email protected]"
    }
  ]
}

PATCH /crew/{id}/availability — Update Availability

PATCHhttps://api.aeroselect.io/api/v1/crew/crew/{id}/availability

FTL Validation

The system automatically validates against FTL limits when creating or updating availability entries. Violations are rejected with HTTP 422 and a detailed error.
cURLBash
curl -X PATCH "https://api.aeroselect.io/api/v1/crew/crew/201/availability" \
  -H "X-API-Key: ak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entries": [
      { "from": "2026-07-01", "to": "2026-07-14", "type": "available" },
      { "from": "2026-07-15", "to": "2026-07-21", "type": "annual_leave", "note": "Summer holiday" }
    ]
  }'