# Flight Slots & PPRs (Trip Support 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 - Trip Support Provider scope

 - [GET /api/v2/partners/flights/{flightId}/slots-pprs](https://developer.fl3xx.com/reference/v2/flight-slots-and-pprs-(trip-support-provider)/partnerslotsandpprsget.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 - Trip Support Provider scope

 - [GET /api/v2/partners/flight-slots-pprs/{id}](https://developer.fl3xx.com/reference/v2/flight-slots-and-pprs-(trip-support-provider)/partnerslotsandpprsbyidget.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 - Trip Support Provider scope

 - [PATCH /api/v2/partners/flight-slots-pprs/{id}](https://developer.fl3xx.com/reference/v2/flight-slots-and-pprs-(trip-support-provider)/partnerslotsandpprsbyidpatch.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 - Trip Support Provider scope

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

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: Each slot/PPR can have only one document associated with it.

## Get document associated with a flight slot/PPR - Trip Support Provider scope

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

## Delete document associated with a flight slot/PPR - Trip Support Provider scope

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