# FBO (Provider)

Manage FBO (Fixed Base Operator) services. These endpoints enable Trip Support Providers to update and retrieve FBO service entries, as well as manage associated documents.

**Note:**  
> FBO services are read-only for properties - only status and remarks can be updated. Creation and deletion are not allowed.


## Get FBO service for a flight - partner scope

 - [GET /api/v2/partners/flights/{flightId}/fbo-services](https://developer.fl3xx.com/reference/v2/fbo-(provider)/partnerfboget.md): Retrieves the FBO (Fixed Base Operator) service information for a specific flight within the partner's scope.

Features:
- Returns FBO service details including status, remarks, and documents
- Includes creation and update timestamps

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

Example Use Case: A trip support provider needs to retrieve FBO service information for a flight to verify service arrangements and check status.

## Get FBO service by ID - partner scope

 - [GET /api/v2/partners/fbo-services/{serviceId}](https://developer.fl3xx.com/reference/v2/fbo-(provider)/partnerfbobyidget.md): Retrieves detailed information about a specific FBO service within the partner's scope, including associated documents.

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

Note: This endpoint is for Trip Support Providers. Only FBO services 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 FBO service, including any uploaded documents, to verify compliance or prepare for audits.

## Update FBO service by ID - partner scope

 - [PATCH /api/v2/partners/fbo-services/{serviceId}](https://developer.fl3xx.com/reference/v2/fbo-(provider)/partnerfbopatch.md): Updates an existing FBO service with new information.

Features:
- Updates FBO service details including status and remarks
- Supports partial updates of FBO service information

Note: This endpoint is for Trip Support Providers. Only FBO services associated with the operator linked to the authentication token can be updated. FBO services are read-only for properties - creation and deletion are not allowed.

Example Use Case: A trip support provider needs to update an FBO service after receiving new status information or when remarks change.

## Upload document associated with an FBO service - partner scope

 - [POST /api/v2/partners/fbo-services/{serviceId}/documents](https://developer.fl3xx.com/reference/v2/fbo-(provider)/partnerfbodocumentpost.md): Uploads a document file to be associated with an FBO service.

Features:
- Supports various document formats
- Associates the document with the specific FBO service
- 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 FBO services associated with the operator linked to the authentication token can have documents uploaded.

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

## Get document associated with an FBO service - partner scope

 - [GET /api/v2/partners/fbo-services/{serviceId}/documents/{uuid}](https://developer.fl3xx.com/reference/v2/fbo-(provider)/partnerfbodocumentget.md): Downloads a document associated with an FBO service.

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

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

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

## Delete document associated with an FBO service - partner scope

 - [DELETE /api/v2/partners/fbo-services/{serviceId}/documents/{uuid}](https://developer.fl3xx.com/reference/v2/fbo-(provider)/partnerfbodocumentdelete.md): Deletes a document associated with an FBO service.

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

Note: This endpoint is for Trip Support Providers. Only documents for FBO services 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 an FBO service.