# Flight Permits (Provider)

Manage flight permits for takeoff, landing, and overflight permissions. These endpoints enable Trip Support Providers to create, update, retrieve, and delete flight permits, as well as manage associated documents.

**Business Value**
- Maintain accurate flight permit records for compliance and regulatory requirements.
- Streamline permit management processes with automated workflows.
- Support document management for permit certificates and approvals.
- Ensure flights have the necessary permissions before operations.

<br/>

**Use Cases**
- Create new flight permits for upcoming flights with permit details and expiration dates.
- Update existing permit information, including permit numbers, status, and dates.
- Retrieve permit information for flights to verify compliance status.
- Upload and manage permit documents, such as certificates and approvals.
- Delete obsolete permits that are no longer valid or relevant.

<br/>

**Note:**  
> All flight‑permit operations are bound to the operator context associated with the authentication token. Trip Support Providers can manage permits only for flights within their own organization.


## Get flight permits - partner scope

 - [GET /api/v2/partners/flights/{flightId}/permits](https://developer.fl3xx.com/reference/v2/flight-permits-(provider)/getflightpermitsforpartner.md): Retrieves all flight permits for a specific flight within the partner's scope.

Features:
- Returns only permits accessible to the authenticated partner
- Includes permit details, status, and document information

Note: This endpoint is for Trip Support Providers. Only permits associated with the operator linked to the authentication token will be returned.

Example Use Case: A trip support provider needs to retrieve all permits for a flight to verify compliance and check permit statuses before departure.

## Get flight permit by ID - partner scope

 - [GET /api/v2/partners/flight-permits/{flightPermitId}](https://developer.fl3xx.com/reference/v2/flight-permits-(provider)/getflightpermitbyidforpartner.md): Retrieves detailed information about a specific flight permit within the partner's scope, including associated documents.

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

Note: This endpoint is for Trip Support Providers. Only permits associated with the operator linked to the authentication token can be retrieved.

Example Use Case: A trip support provider needs to review the complete details of a specific permit, including any uploaded documents, to verify compliance or prepare for audits.

## Update flight permit by ID - partner scope

 - [PATCH /api/v2/partners/flight-permits/{flightPermitId}](https://developer.fl3xx.com/reference/v2/flight-permits-(provider)/updateflightpermitbyidforpartner.md): Updates an existing flight permit with new information.

Features:
- Updates permit details including permit number, status, dates, and notes
- Supports partial updates of permit information

Note: This endpoint is for Trip Support Providers. Only permits associated with the operator linked to the authentication token can be updated.

Example Use Case: A trip support provider needs to update a permit after receiving a new permit number or when permit status changes.

## Delete flight permit by ID - partner scope

 - [DELETE /api/v2/partners/flight-permits/{flightPermitId}](https://developer.fl3xx.com/reference/v2/flight-permits-(provider)/deleteflightpermitbyidforpartner.md): Deletes a flight permit and removes it from the system.

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

Note: This endpoint is for Trip Support Providers. Only permits associated with the operator linked to the authentication token can be deleted.

Example Use Case: A trip support provider needs to remove an obsolete permit that is no longer valid or relevant for a flight.

## Create flight permit - partner scope

 - [POST /api/v2/partners/flight-permits](https://developer.fl3xx.com/reference/v2/flight-permits-(provider)/createflightpermitforpartner.md): Creates a new flight permit for a flight with permit details, status, and dates.

Features:
- Validates required fields including flight ID and permit type
- Supports permit number, status, dates, country, and airport information
- Handles takeoff, landing, and overflight permit types

Note: This endpoint is for Trip Support Providers. Only permits for flights associated with the operator linked to the authentication token can be created.

Example Use Case: A trip support provider needs to create a new landing permit for a flight after receiving approval from the destination country's aviation authority.

## Upload document associated with a flight permit - partner scope

 - [POST /api/v2/partners/flight-permits/{flightPermitId}/documents](https://developer.fl3xx.com/reference/v2/flight-permits-(provider)/uploadflightpermitdocumentforpartner.md): Uploads a document file to be associated with a flight permit.

Features:
- Supports various document formats
- Associates the document with the specific permit
- Returns confirmation of upload

Supported File Types:
- Images: All image formats (JPEG, PNG, GIF, BMP, etc.) except SVG
- Documents: PDF, Microsoft Office (Word, Excel, PowerPoint: .doc, .docx, .xls, .xlsx, .ppt, .pptx), OpenDocument formats (.odt, .ods), Microsoft Word legacy (.doc)
- Other: Email messages (.eml), Apple Passbook (.pkpass)

File Size Limits:
- Maximum file size: 5 MB (5,242,880 bytes)

Note: This endpoint is for Trip Support Providers. Only permits associated with the operator linked to the authentication token can have documents uploaded. Each permit can have only one document associated with it.

Example Use Case: A trip support provider needs to upload a scanned copy of a permit certificate or approval document to maintain digital records for compliance and verification.

## Get document associated with a flight permit - partner scope

 - [GET /api/v2/partners/flight-permits/{flightPermitId}/documents/{documentUuid}](https://developer.fl3xx.com/reference/v2/flight-permits-(provider)/getflightpermitdocumentforpartner.md): Downloads a document associated with a flight permit.

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

Note: This endpoint is for Trip Support Providers. Only documents for permits associated with the operator linked to the authentication token can be downloaded.

Example Use Case: A trip support provider needs to download a permit certificate or approval document for verification or compliance purposes.

## Delete document associated with a flight permit - partner scope

 - [DELETE /api/v2/partners/flight-permits/{flightPermitId}/documents/{documentUuid}](https://developer.fl3xx.com/reference/v2/flight-permits-(provider)/deleteflightpermitdocumentforpartner.md): Deletes a document associated with a flight permit.

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

Note: This endpoint is for Trip Support Providers. Only documents for permits associated with the operator linked to the authentication token can be deleted.

Example Use Case: A trip support provider needs to remove an outdated or incorrect document that was previously uploaded for a permit.