# Trips

APIs to manage trips.

## Create trip

 - [POST /v2/trips](https://developer.spotnana.com/openapi/tripapi/trips/createtrip.md): This endpoint creates a trip object. A trip is a container object for all related PNRs associated 
with a trip.

## Update trip

 - [PUT /v2/trips/{tripId}](https://developer.spotnana.com/openapi/tripapi/trips/updatetrip.md): This endpoint updates trip by ID.

## Get trip details

 - [GET /v3/trips/{tripId}/detail](https://developer.spotnana.com/openapi/tripapi/trips/gettripdetailsv3.md): This endpoint gets trip details for a given trip ID.

## Delete trip

 - [DELETE /v3/trips/{tripId}](https://developer.spotnana.com/openapi/tripapi/trips/deletetrip.md): This endpoint deletes a trip by ID.

## Update trip details for trip Id

 - [POST /v3/trips/{tripId}](https://developer.spotnana.com/openapi/tripapi/trips/updatetripv3.md)

## List trip summaries for a user

 - [POST /v3/trips/users/{userId}/list](https://developer.spotnana.com/openapi/tripapi/trips/getusertripsummarieslist.md): Retrieves the list of trip summaries associated with a user.

## List trip summaries for a company

 - [POST /v3/trips/companies/{companyId}/list](https://developer.spotnana.com/openapi/tripapi/trips/getcompanytripsummarieslist.md): Retrieves the list of trip summaries associated with a company.

## List trip summaries for travelers managed by an arranger

 - [POST /v3/trips/arrangers/{arrangerId}/list](https://developer.spotnana.com/openapi/tripapi/trips/getarrangermanagedtripsummarieslist.md): Retrieves the list of trip summaries for all travelers managed by a specific arranger.
This endpoint can be used for arrangers whose role types are COMPANY_TRAVEL_ARRANGER or TRAVEL_ARRANGER.

## Get trip partner info

 - [GET /v2/trips/{tripId}/booker-email/{bookerEmailId}/partner-info](https://developer.spotnana.com/openapi/tripapi/trips/fetchtrippartnerinfo.md): This endpoint provides info related to partner for the trip.

## Create PNR

 - [POST /v3/trips/{tripId}/pnrs](https://developer.spotnana.com/openapi/tripapi/trips/createpnrv3.md): Create a new Passenger Name Record (PNR). A PNR represents a booking (air, hotel, rail, or car) made on the Spotnana platform.
You can also use this endpoint to import bookings made from external sources into the Spotnana platform.

## Get PNR

 - [GET /v3/trips/{tripId}/pnrs/{pnrId}](https://developer.spotnana.com/openapi/tripapi/trips/getpnrv3.md): This endpoint gets PNR for a given trip ID and PNR ID.

## Update PNR

 - [PUT /v3/trips/{tripId}/pnrs/{pnrId}](https://developer.spotnana.com/openapi/tripapi/trips/updatepnrv3.md): This endpoint updates PNR by ID.

## Add Remark

 - [POST /v3/trips/{tripId}/pnrs/{pnrId}/remarks](https://developer.spotnana.com/openapi/tripapi/trips/addremarkv3.md): This endpoint provided adding third party remarks to the given PNR.

## Finalize the given pnr.

 - [POST /v3/trips/{tripId}/pnrs/{pnrId}/finalize](https://developer.spotnana.com/openapi/tripapi/trips/finalizepnr.md): This endpoint changes the metadata of PNR to finalized and triggers supplier actions if required.

## Suspend the given pnr.

 - [POST /v3/trips/{tripId}/pnrs/{pnrId}/suspend](https://developer.spotnana.com/openapi/tripapi/trips/suspendpnr.md): This endpoint suspends the PNR, transitioning it into a read-only state.
Once suspended, updates via OBT will be restricted.
This API serves various use cases, such as price optimization and rebooking.

## Cancel PNR

 - [POST /v3/trips/{tripId}/pnrs/{pnrId}/cancel](https://developer.spotnana.com/openapi/tripapi/trips/cancelpnrv3.md): This endpoint cancels PNR or part of PNR object.In case of partial PNR cancel we can cancel journey/ticket.

## Get cancellation details

 - [GET /v2/trips/{tripId}/pnrs/{pnrId}/cancellation-details](https://developer.spotnana.com/openapi/tripapi/trips/getcancellationdetails.md): This endpoint gets cancellation details for a given trip ID and PNR ID.

## Download PNR invoice

 - [POST /v2/trips/{tripId}/pnrs/{pnrId}/download-invoice](https://developer.spotnana.com/openapi/tripapi/trips/downloadinvoice.md): This endpoint downloads invoice on demand for a given trip ID and PNR ID.

## Process the PNR approval

 - [POST /v2/pnrs/{pnrId}/process-approval](https://developer.spotnana.com/openapi/tripapi/trips/processpnrapproval.md): Approve or decline a PNR.

## Get PNR by external Id

 - [GET /v2/pnrs](https://developer.spotnana.com/openapi/tripapi/trips/getpnrbyexternalid.md): This endpoint gets PNR Id and Trip Id for a given external Id.

## Find Pnr details like BookingId and TripId

 - [GET /v2/pnrs/search](https://developer.spotnana.com/openapi/tripapi/trips/pnrsearch.md): This API gets Pnr details for a given Source Pnr/ Ticket Number/ Vendor Confirmation.

## Get trip (deprecated)

 - [GET /v2/trips/{tripId}](https://developer.spotnana.com/openapi/tripapi/trips/readtrip.md): Retrieves trip info by ID.
{% admonition type="warning" name="Deprecation notice" %}
The Get Trip /v2/trips/{tripId} endpoint has been deprecated.
Use the new Get trip details /v3/trips/{tripId}/detail endpoint instead.
{% /admonition %}

## List trips (deprecated)

 - [POST /v2/list-organisation-trips](https://developer.spotnana.com/openapi/tripapi/trips/listorganisationtrips.md): Retrieves the list of trips associated with an organization.
{% admonition type="warning" name="Deprecation notice" %}
The List Trips /v2/list-organisation-trips endpoint has been deprecated.
Use the new List trip summaries for a company /v3/trips/companies/{companyId}/list endpoint instead.
{% /admonition %}