# Hotel (Trip Support 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 - Trip Support Provider scope

 - [GET /api/v2/partners/flights/{flightId}/hotel-services](https://developer.fl3xx.com/reference/v2/hotel-(trip-support-provider)/partnerhotelsget.md): Retrieves all hotel service entries for a specific flight within the partner's scope. Returns a list of hotel service objects including status, assignment, airport, notes, and associated document UUIDs.

Assignment (for): Each hotel service is assigned either to a group or to one person, never both:
- "for": {"group": "PAX"} or "for": {"group": "CREW"} — the service applies to the whole passenger or crew group
- "for": {"person": {"id": "...", "name": "..."}} — the service is assigned to a single individual, who can be a passenger or a crew member. person.id is the userId.

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

Note: This endpoint is for Trip Support Providers. Hotel services can only be created for flights of the operator linked to the authentication token, and only if the partner is assigned to the flight.

Example Use Case: A Trip Support Provider checks which hotel arrangements already exist for a flight before creating a new one.

## Get hotel service by ID - Trip Support Provider scope

 - [GET /api/v2/partners/hotel-services/{id}](https://developer.fl3xx.com/reference/v2/hotel-(trip-support-provider)/partnerhotelbyidget.md): Retrieves the full details of a single hotel service by its ID, including status, assignment, airport, notes, and the metadata of all associated documents.

Assignment (for): Each hotel service is assigned either to a group or to one person, never both:
- "for": {"group": "PAX"} or "for": {"group": "CREW"} — the service applies to the whole passenger or crew group
- "for": {"person": {"id": "...", "name": "..."}} — the service is assigned to a single individual, who can be a passenger or a crew member. person.id is the userId.

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

Note: This endpoint is for Trip Support Providers. Hotel services can only be created for flights of the operator linked to the authentication token, and only if the partner is assigned to the flight.

Example Use Case: A Trip Support Provider opens a hotel service entry to review its current status and attached confirmation documents.

## Update hotel service by ID - Trip Support Provider scope

 - [PATCH /api/v2/partners/hotel-services/{id}](https://developer.fl3xx.com/reference/v2/hotel-(trip-support-provider)/partnerhotelpatch.md): Updates an existing hotel service by its ID.

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

Assignment (for): Each hotel service is assigned either to a group or to one person, never both:
- "for": {"group": "PAX"} or "for": {"group": "CREW"} — the service applies to the whole passenger or crew group
- "for": {"person": {"id": "...", "name": "..."}} — the service is assigned to a single individual, who can be a passenger or a crew member. person.id is the userId.

Partial updates supported: The request body can contain any subset of the fields — only the fields provided will be updated. Omitted fields remain unchanged.

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

Note: This endpoint is for Trip Support Providers. Hotel services can only be created for flights of the operator linked to the authentication token, and only if the partner is assigned to the flight.

Example Use Case: A Trip Support Provider sets the status to OK after the hotel booking has been confirmed with the property.

## Delete hotel service by ID - Trip Support Provider scope

 - [DELETE /api/v2/partners/hotel-services/{id}](https://developer.fl3xx.com/reference/v2/hotel-(trip-support-provider)/partnerhoteldelete.md): Deletes a hotel service by its ID.

Note: This endpoint is for Trip Support Providers. Only hotel services associated with the operator linked to the authentication token can be deleted. Deletion is only allowed if the hotel service was created by the partner; hotel services created by the operator cannot be deleted.

Note: This endpoint is for Trip Support Providers. Hotel services can only be created for flights of the operator linked to the authentication token, and only if the partner is assigned to the flight.

Example Use Case: A Trip Support Provider removes a hotel service entry that was created by mistake or is no longer needed.

## Create hotel service - Trip Support Provider scope

 - [POST /api/v2/partners/hotel-services](https://developer.fl3xx.com/reference/v2/hotel-(trip-support-provider)/partnerhotelpost.md): Creates a new hotel service for a flight.

Features:
- Creates a hotel service with status, assignment, airport, and notes
- The flight is specified via the required flightId field in the request body — unlike the other hotel endpoints, the flightId is not part of the URL path
- The airport the service applies to is set via the airport object in the request body

Assignment (for): Each hotel service is assigned either to a group or to one person, never both:
- "for": {"group": "PAX"} or "for": {"group": "CREW"} — the service applies to the whole passenger or crew group
- "for": {"person": {"id": "...", "name": "..."}} — the service is assigned to a single individual, who can be a passenger or a crew member. person.id is the userId.

Note: This endpoint is for Trip Support Providers. Hotel services can only be created for flights of the operator linked to the authentication token, and only if the partner is assigned to the flight.

Example Use Case: A Trip Support Provider creates a hotel booking entry for the crew of an upcoming flight.

## Upload document associated with a hotel service - Trip Support Provider scope

 - [POST /api/v2/partners/hotel-services/{id}/documents](https://developer.fl3xx.com/reference/v2/hotel-(trip-support-provider)/partnerhoteldocumentpost.md): Uploads a document file to be associated with a hotel service. Maximum file size is 5 MB.

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

Note: This endpoint is for Trip Support Providers. Hotel services can only be created for flights of the operator linked to the authentication token, and only if the partner is assigned to the flight.

Example Use Case: A Trip Support Provider attaches the booking confirmation received from the hotel to the hotel service entry.

## Get document associated with a hotel service - Trip Support Provider scope

 - [GET /api/v2/partners/hotel-services/{id}/documents/{documentUuid}](https://developer.fl3xx.com/reference/v2/hotel-(trip-support-provider)/partnerhoteldocumentget.md): Downloads a document associated with a hotel service. The response contains the binary file content.

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

Note: This endpoint is for Trip Support Providers. Hotel services can only be created for flights of the operator linked to the authentication token, and only if the partner is assigned to the flight.

Example Use Case: A Trip Support Provider retrieves a previously uploaded booking confirmation to verify the details.

## Delete document associated with a hotel service - Trip Support Provider scope

 - [DELETE /api/v2/partners/hotel-services/{id}/documents/{documentUuid}](https://developer.fl3xx.com/reference/v2/hotel-(trip-support-provider)/partnerhoteldocumentdelete.md): Deletes a document associated with a hotel service.

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

Note: This endpoint is for Trip Support Providers. Hotel services can only be created for flights of the operator linked to the authentication token, and only if the partner is assigned to the flight.

Example Use Case: A Trip Support Provider removes an outdated booking confirmation after uploading a revised version.