Bidding
Crew members can submit roster preferences. Dispatchers approve or reject bid requests.
Bid Request Object
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | integer | Optional | Unique bid request ID |
| crew_member_id | integer | Pflicht | Submitting crew member |
| type | enum | Pflicht | pairing_preference | day_off | swap_request | vacation |
| priority | enum | Optional | low | normal | high |
| details | object | Pflicht | Type-specific details (see below) |
| status | enum | Optional | pending | approved | rejected | withdrawn |
| reviewer_id | integer|null | Optional | Dispatcher who processed the request |
| rejection_reason | string|null | Optional | Reason for rejection |
| submitted_at | datetime | Optional | Submission timestamp |
| reviewed_at | datetime|null | Optional | Review 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." }'