# Crew Qualifications

Manage crew qualifications and certifications. These endpoints enable partners to assign, update, and manage crew member qualifications including licenses, certifications, and associated documents.

**Business Value**
- Maintain accurate crew qualification records for compliance and safety.
- Streamline qualification assignment and management processes.
- Support document management for qualification certificates and licenses.
- Ensure crew members meet operational requirements and regulations.

<br/>

**Use Cases**
- Assign new qualifications to crew members with license details and expiration dates.
- Update existing qualification information including license numbers and issuing authorities.
- Upload and manage qualification documents such as certificates and licenses.
- Retrieve qualification information for crew members and compliance reporting.
- Delete obsolete qualifications and associated documents.

<br/>

**Note:**  
> All crew qualification operations are bound to the operator context associated with the authentication token. Partners can only manage qualifications for crew members within their organization.


## Get crew qualifications

 - [GET /api/external/crew-qualifications](https://developer.fl3xx.com/reference/crew-qualifications/getcrewqualifications.md): Retrieve crew qualifications with pagination and filtering capabilities.


- Filter by crew ID (required)
- Paginated results

 An operations manager needs to retrieve all qualifications for a specific crew member to verify compliance status and upcoming expiration dates.


## Assign a qualification to a crew member

 - [POST /api/external/crew-qualifications](https://developer.fl3xx.com/reference/crew-qualifications/assignqualificationtocrew.md): Assign a new qualification to a crew member with license details, expiration dates, and other relevant information.


- Validates required fields including crew ID and qualification ID
- Supports license numbers, issuing authorities, and country information
- Handles pilot-in-command designations and base month calculations

 An operations manager needs to assign a new type rating qualification to a pilot after completing training. This endpoint allows them to create the qualification record with all necessary details.


## Get a crew qualification by ID

 - [GET /api/external/crew-qualifications/{crewQualificationId}](https://developer.fl3xx.com/reference/crew-qualifications/getcrewqualificationbyid.md): Retrieve detailed information about a specific crew qualification including associated documents.


- Returns complete qualification details including document references
- Includes creation and update timestamps

 An operations manager needs to review the complete details of a specific qualification, including any uploaded documents, to verify compliance or prepare for audits.


## Update a crew qualification by ID

 - [PATCH /api/external/crew-qualifications/{crewQualificationId}](https://developer.fl3xx.com/reference/crew-qualifications/updatecrewqualificationbyid.md): Update an existing crew qualification with new information.


- Updates qualification details including license numbers and dates
- Supports partial updates of qualification information

 An operations manager needs to update a qualification after a license renewal or when additional information becomes available.


## Delete a crew qualification by ID

 - [DELETE /api/external/crew-qualifications/{crewQualificationId}](https://developer.fl3xx.com/reference/crew-qualifications/deletecrewqualificationbyid.md): Delete a crew qualification and remove it from the system.


- Permanently removes the qualification record
- Returns confirmation of deletion

 An operations manager needs to remove an obsolete qualification that is no longer valid or relevant for a crew member.


## Get document associated with a crew qualification

 - [GET /api/external/crew-qualifications/{crewQualificationId}/documents/{documentUuid}](https://developer.fl3xx.com/reference/crew-qualifications/getcrewqualificationdocument.md): Download a document associated with a crew qualification.


- Downloads the actual document file
- Validates document ownership and access permissions

 An operations manager needs to download a qualification certificate or license document for verification or compliance purposes.


## Upload document associated with a crew qualification

 - [POST /api/external/crew-qualifications/{crewQualificationId}/documents](https://developer.fl3xx.com/reference/crew-qualifications/uploadcrewqualificationdocument.md): Upload a document file to be associated with a crew qualification.


- Supports various document formats
- Associates the document with the specific qualification
- Returns document metadata including UUID for future access

 An operations manager needs to upload a scanned copy of a pilot's license or certificate to maintain digital records for compliance and verification.


## Delete document associated with a crew qualification

 - [DELETE /api/external/crew-qualifications/{crewQualificationId}/documents/{uuid}](https://developer.fl3xx.com/reference/crew-qualifications/deletecrewqualificationdocument.md): Delete a document associated with a crew qualification.


- Permanently removes the document file
- Returns confirmation of deletion

 An operations manager needs to remove an outdated or incorrect document that was previously uploaded for a qualification.


## Get qualification types

 - [GET /api/external/qualification-types](https://developer.fl3xx.com/reference/crew-qualifications/getqualificationtypes.md): Retrieve available qualification types and their details for use in crew qualification assignments.


- Returns paginated list of available qualifications
- Includes qualification metadata and configuration

 An operations manager needs to see all available qualification types in the system to properly assign qualifications to crew members.


## Get qualification type by ID

 - [GET /api/external/qualification-types/{id}](https://developer.fl3xx.com/reference/crew-qualifications/getqualificationtypebyid.md): Retrieve detailed information about a specific qualification type.


- Returns complete qualification configuration and metadata
- Includes validity periods, grace periods, and relation information

 An operations manager needs to understand the specific requirements and configuration of a qualification type before assigning it to a crew member.