# 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/>

For more information on managing crew qualifications, see the [Crew Qualification Management Guide](/guides/guides/crew-qualification).

**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.

Features:
- Filter by crew ID (required)
- Paginated results

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

For more information on managing crew qualifications, see the Crew Qualification Management Guide.

## 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.

Features:
- 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

Example Use Case: 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.

For more information on managing crew qualifications, see the Crew Qualification Management Guide.

## 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.

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

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

For more information on managing crew qualifications, see the Crew Qualification Management Guide.

## Update a crew qualification by ID

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

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

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

For more information on managing crew qualifications, see the Crew Qualification Management Guide.

## Delete a crew qualification by ID

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

Features:
- Permanently removes the qualification record
- Returns confirmation of deletion

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

For more information on managing crew qualifications, see the Crew Qualification Management Guide.

## 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.

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

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

For more information on managing crew qualifications, see the Crew Qualification Management Guide.

## 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.

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

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

For more information on managing crew qualifications, see the Crew Qualification Management Guide.

## Delete document associated with a crew qualification

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

Features:
- Permanently removes the document file
- Returns confirmation of deletion

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

For more information on managing crew qualifications, see the Crew Qualification Management Guide.

## 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.

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

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

For more information on managing crew qualifications, see the Crew Qualification Management Guide.

## 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.

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

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

For more information on managing crew qualifications, see the Crew Qualification Management Guide.