# Crew Position

Search crew positions configured for specific aircraft. Crew positions define the roles and slots available on an aircraft (e.g., Captain, First Officer, Flight Attendant) and are used when creating or updating roster assignments with aircraft details.

**Business Value**
- Discover valid crew positions for a given aircraft before creating roster assignments.
- Ensure correct crew-position assignments by querying only positions linked to the target aircraft.
- Support dynamic crew-assignment interfaces that display only applicable positions.

<br/>

**Use Cases**
- Retrieve available crew positions for an aircraft by tail number or aircraft id.
- Filter positions by assignability to show only positions that can be used in roster assignments.
- Validate crew-position selection before submitting a roster assignment create or update request.

<br/>


## Search crew positions for an aircraft

 - [POST /api/v2/crew-position-search](https://developer.fl3xx.com/reference/v2/crew-position/crewpositionsearch.md): Returns a paginated list of crew positions configured for a specific aircraft. Exactly one of aircraftId or tailNumber must be provided in filters.

Features:
- Search by aircraft id or tail number
- Filter by assignability to show only positions usable in roster assignments
- Sort results by position name
- Paginated response

Crew positions returned by this endpoint can be used as crewPositionId in roster assignment create and update requests (see aircraft.crewPositionId on roster assignment endpoints). The crew position must belong to the aircraft specified in the assignment.