# Trip API

Version: v2

## Servers

Staging URL
```
https://apis.spotnana.com
```

## Security

### Bearer

Type: http
Scheme: bearer

## Download OpenAPI description

[Trip API](https://developer.spotnana.com/_bundle/openapi/TripApi.yaml)

## 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 %}

## Invoicing

APIs to manage invoicing.

### Get Invoice Data

 - [POST /v2/invoicing/invoice-data](https://developer.spotnana.com/openapi/tripapi/invoicing/getinvoicedata.md): This endpoint gets the invoice data for given invoice numbers

## Approval

APIs to manage approvals.

### List approval data for an approver

 - [POST /v3/approvals/approvers/{userId}/list](https://developer.spotnana.com/openapi/tripapi/approval/getapprovaluserapprovaldatalist.md): Retrieves the list of approval data associated with an approver.

### List approval data for a company

 - [POST /v3/approvals/companies/{companyId}/list](https://developer.spotnana.com/openapi/tripapi/approval/getcompanyapprovaldatalist.md): Retrieves the list of approval data associated with a company.