# Flight Slots & PPRs (Provider)

Manage flight slots and PPRs (Prior Permission Required). These endpoints enable Trip Support Providers to update, retrieve, and manage flight slots and PPRs, as well as manage associated documents.

**Business Value**
- Maintain accurate flight slot and PPR records for compliance and operational requirements.
- Streamline slot and PPR management processes with automated workflows.
- Support document management for slot and PPR certificates and approvals.
- Ensure flights have the necessary slots and PPRs before operations.

<br/>

**Use Cases**
- Update existing slot and PPR information, including permit numbers, status, and approval dates.
- Retrieve slot and PPR information for flights to verify compliance status.
- Upload and manage slot and PPR documents, such as certificates and approvals.
- Delete obsolete slot and PPR documents that are no longer valid or relevant.

<br/>

**Note:**  
> All flight slot and PPR operations are bound to the operator context associated with the authentication token. Trip Support Providers can manage slots and PPRs only for flights within their own organization.


## Get flight slots and PPRs - partner scope

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

Features:
- Returns only slots and PPRs accessible to the authenticated partner
- Includes slot/PPR details, status, and document information

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

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

## Get flight slot/PPR by ID - partner scope

 - [GET /api/v2/partners/flight-slots-pprs/{slotPprId}](https://developer.fl3xx.com/reference/v2/flight-slots-and-pprs-(provider)/getslotpprbyidforpartner.md): Retrieves detailed information about a specific flight slot or PPR within the partner's scope, including associated documents.

Features:
- Returns complete slot/PPR details including document references
- Includes creation and update timestamps

Note: This endpoint is for Trip Support Providers. Only slots and PPRs 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 slot or PPR, including any uploaded documents, to verify compliance or prepare for audits.

## Update flight slot/PPR by ID - partner scope

 - [PATCH /api/v2/partners/flight-slots-pprs/{slotPprId}](https://developer.fl3xx.com/reference/v2/flight-slots-and-pprs-(provider)/updateflightslotpprbyidforpartner.md): Updates an existing flight slot or PPR with new information.

Features:
- Updates slot/PPR details including permit number, status, approval date, and notes
- Supports partial updates of slot/PPR information

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

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

## Upload document associated with a flight slot/PPR - partner scope

 - [POST /api/v2/partners/flight-slots-pprs/{slotPprId}/documents](https://developer.fl3xx.com/reference/v2/flight-slots-and-pprs-(provider)/uploadflightslotpprdocumentforpartner.md): Uploads a document file to be associated with a flight slot or PPR.

Features:
- Supports various document formats
- Associates the document with the specific slot/PPR
- 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 slots and PPRs associated with the operator linked to the authentication token can have documents uploaded. Each slot/PPR can have only one document associated with it.

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

## Get document associated with a flight slot/PPR - partner scope

 - [GET /api/v2/partners/flight-slots-pprs/{slotPprId}/documents/{documentUuid}](https://developer.fl3xx.com/reference/v2/flight-slots-and-pprs-(provider)/getflightslotpprdocumentforpartner.md): Downloads a document associated with a flight slot or PPR.

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

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

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

## Delete document associated with a flight slot/PPR - partner scope

 - [DELETE /api/v2/partners/flight-slots-pprs/{slotPprId}/documents/{documentUuid}](https://developer.fl3xx.com/reference/v2/flight-slots-and-pprs-(provider)/deleteflightslotpprdocumentforpartner.md): Deletes a document associated with a flight slot or PPR.

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

Note: This endpoint is for Trip Support Providers. Only documents for slots and PPRs 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 slot or PPR.