API reference

Trip

Get cancellation details

Trip API (v2)

Download OpenAPI description

TripApi.json

TripApi.yaml

Servers

Staging URL

https://apis.spotnana.com/

Spotnana mock server

https://developer.spotnana.com/_mock/openapi/tripapi/

Trips

APIs to manage trips and PNRs.

Operations

Get trip partner info

Request

This endpoint provides info related to partner for the trip.

Path

tripIdstringrequired

Identifier for trip.

Example: 2398199412

bookerEmailIdstringrequired

Booker Email Id for whom budget info will be fetched.

Example: akanksha@spotnana.com

curl -i -X GET \
  https://apis.spotnana.com/v2/trips/2398199412/booker-email/akanksha@spotnana.com/partner-info \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Bodyapplication/json

tripIdstringrequired

Spotnana trip Id

Example: "6926658168"

partnerInfoobject(TripPartnerInfo)required

Partner info such as budget info for a given trip Id.

partnerInfo.partnerInfoTypestring(TripPartnerInfoType)required

Trip Partner Info type.

Value"BUDGET"

partnerInfo.partnerInfoDetailsTripPartnerInfoDetailsWrapper (object)(TripPartnerInfoDetails)required

One of:

Trip budget info wrapper

partnerInfo.partnerInfoDetails.tripBudgetInfoobject(TripBudgetInfo)

Trip budget Info

Response

application/json

{
  "tripId": "6926658168",
  "partnerInfo": {
    "partnerInfoType": "BUDGET",
    "partnerInfoDetails": { … }
  }
}

Get cancellation details

Request

This endpoint gets cancellation details for a given trip ID and PNR ID.

Path

tripIdstringrequired

Trip ID.

Example: 1234567890

pnrIdstringrequired

PNR ID.

Example: 6926658168

curl -i -X GET \
  https://apis.spotnana.com/v2/trips/1234567890/pnrs/6926658168/cancellation-details \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Bodyapplication/json

pnrIdstringrequired

PNR ID for the booking.

Example: "1234567890"

tripIdstringrequired

Trip ID for the booking.

Example: "2345678901"

cancellationDetailsCancellationDetails (object) or CancellationDetails (object)(CancellationDetails)

One of:

Cancellation details for this booking.

Response

application/json

{
  "pnrId": "1234567890",
  "tripId": "2345678901",
  "cancellationDetails": {
    "air": { … }
  }
}

Get PNR by external Id

Request

This endpoint gets PNR Id and Trip Id for a given external Id.

Query

externalIdstringrequired

External ID

Example: externalId=external-pnr-id

curl -i -X GET \
  'https://apis.spotnana.com/v2/pnrs?externalId=external-pnr-id' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Bodyapplication/json

pnrIdstringrequired

Spotnana PNR Id mapped with external Id

Example: "1234567890"

tripIdstringrequired

Spotnana trip Id mapped with external Id

Example: "1234567890"

Response

application/json

{
  "pnrId": "1234567890",
  "tripId": "1234567890"
}

Invoicing

Operations

Approval

Operations