# Catering (Provider)

Manage catering services. These endpoints enable Trip Support Providers to create, update, retrieve, and delete catering service entries, as well as manage associated documents.

**Note:**  
> Catering services can be created if the partner is assigned to the flight. Deletion is only allowed if the catering service was created by the partner.


## Get catering services for a flight - partner scope

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

Features:
- Returns only catering services accessible to the authenticated partner
- Includes catering service details, status, service for, order, pax, and document information

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

Example Use Case: A trip support provider needs to retrieve all catering services for a flight to verify service arrangements and check statuses.

## Get catering service by ID - partner scope

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

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

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

## Update catering service by ID - partner scope

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

Features:
- Updates catering service details including status, service for, order, and pax
- Supports partial updates of catering service information

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

Example Use Case: A trip support provider needs to update a catering service after receiving new status information or when service details change.

## Delete catering service by ID - partner scope

 - [DELETE /api/v2/partners/catering-services/{serviceId}](https://developer.fl3xx.com/reference/v2/catering-(provider)/partnercateringdelete.md): Deletes a catering service and removes it from the system.

Features:
- Permanently removes the catering service record
- Returns confirmation of deletion
- Only allowed if the catering service was created by the partner (check "by" field)

Note: This endpoint is for Trip Support Providers. Only catering services associated with the operator linked to the authentication token and created by the partner can be deleted.

Example Use Case: A trip support provider needs to remove a catering service entry that was created in error or is no longer needed.

## Create catering service - partner scope

 - [POST /api/v2/partners/catering-services](https://developer.fl3xx.com/reference/v2/catering-(provider)/partnercateringpost.md): Creates a new catering service for a flight with catering details, status, service for, order, and pax.

Features:
- Validates required fields including flight ID
- Supports service for (PAX, CREW, etc.), status, order, and pax count
- Handles catering service assignments

Note: This endpoint is for Trip Support Providers. Only catering services for flights associated with the operator linked to the authentication token and where the partner is assigned can be created.

Example Use Case: A trip support provider needs to create a new catering service for a flight after arranging catering for passengers or crew.

## Upload document associated with a catering service - partner scope

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

Features:
- Supports various document formats
- Associates the document with the specific catering 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 catering 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 a catering confirmation or approval document to maintain digital records for compliance and verification.

## Get document associated with a catering service - partner scope

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

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

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

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

## Delete document associated with a catering service - partner scope

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

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

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