# Transport (Provider)

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

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


## Get transport services for a flight - partner scope

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

Features:
- Returns only transport services accessible to the authenticated partner
- Includes transport service details, status, type, person, and document information

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

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

## Get transport service by ID - partner scope

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

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

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

## Update transport service by ID - partner scope

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

Features:
- Updates transport service details including status, type, person, and notes
- Supports partial updates of transport service information

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

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

## Delete transport service by ID - partner scope

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

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

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

## Create transport service - partner scope

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

Features:
- Validates required fields including flight ID
- Supports transport type, status, person assignment, and notes
- Handles various transport types (Limousine, CarRental, Taxi, GroundTransportation)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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