Bidding

Crew members can submit roster preferences. Dispatchers approve or reject bid requests.

Bid Request Object

FeldTypPflichtBeschreibung
idintegerOptionalUnique bid request ID
crew_member_idintegerPflichtSubmitting crew member
typeenumPflichtpairing_preference | day_off | swap_request | vacation
priorityenumOptionallow | normal | high
detailsobjectPflichtType-specific details (see below)
statusenumOptionalpending | approved | rejected | withdrawn
reviewer_idinteger|nullOptionalDispatcher who processed the request
rejection_reasonstring|nullOptionalReason for rejection
submitted_atdatetimeOptionalSubmission timestamp
reviewed_atdatetime|nullOptionalReview timestamp

GET /bid-requests — List Requests

GEThttps://api.aeroselect.io/api/v1/crewops/bid-requests
cURLBash
curl "https://api.aeroselect.io/api/v1/crewops/bid-requests?status=pending" \
  -H "X-API-Key: ak_live_YOUR_KEY"
Response 200JSON
{
  "data": [
    {
      "id": 1101,
      "crew_member_id": 215,
      "type": "day_off",
      "priority": "normal",
      "details": {
        "date": "2026-06-20",
        "reason": "Family event"
      },
      "status": "pending",
      "reviewer_id": null,
      "submitted_at": "2026-05-20T09:00:00Z"
    }
  ]
}

POST /bid-requests — Submit a Request

POSThttps://api.aeroselect.io/api/v1/crewops/bid-requests
cURL — Day OffBash
curl -X POST "https://api.aeroselect.io/api/v1/crewops/bid-requests" \
  -H "X-API-Key: ak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "crew_member_id": 215,
    "type": "day_off",
    "priority": "high",
    "details": {
      "date": "2026-07-04",
      "reason": "Wedding"
    }
  }'
cURL — Pairing PreferenceBash
curl -X POST "https://api.aeroselect.io/api/v1/crewops/bid-requests" \
  -H "X-API-Key: ak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "crew_member_id": 201,
    "type": "pairing_preference",
    "priority": "normal",
    "details": {
      "preferred_routes": ["FRA-JFK", "FRA-ORD"],
      "avoid_routes": ["FRA-MUC"],
      "period": { "from": "2026-07-01", "to": "2026-07-31" }
    }
  }'

PATCH /bid-requests/{id}/approve — Approve/Reject a Request

PATCHhttps://api.aeroselect.io/api/v1/crewops/bid-requests/{id}/approve
cURL — ApproveBash
curl -X PATCH "https://api.aeroselect.io/api/v1/crewops/bid-requests/1101/approve" \
  -H "X-API-Key: ak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "decision": "approved" }'
cURL — RejectBash
curl -X PATCH "https://api.aeroselect.io/api/v1/crewops/bid-requests/1101/approve" \
  -H "X-API-Key: ak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "decision": "rejected", "rejection_reason": "No replacement available for this day." }'