# Hotel (Provider)

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

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


## Get hotel services for a flight - partner scope

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

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

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

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

## Get hotel service by ID - partner scope

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

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

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

## Update hotel service by ID - partner scope

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

Features:
- Updates hotel service details including status, service for, and notes
- Supports partial updates of hotel service information

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

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

## Delete hotel service by ID - partner scope

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

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

Note: This endpoint is for Trip Support Providers. Only hotel 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 hotel service entry that was created in error or is no longer needed.

## Create hotel service - partner scope

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

Features:
- Validates required fields including flight ID
- Supports service for (PAX, CREW, etc.), status, and notes
- Handles hotel service assignments

Note: This endpoint is for Trip Support Providers. Only hotel 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 hotel service for a flight after arranging hotel accommodations for passengers or crew.

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

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

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