API reference

Trip

Download PNR invoice

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.

Operations

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": { … }
  }
}

Download PNR invoice

Request

This endpoint downloads invoice on demand for a given trip ID and PNR ID.

Path

tripIdstringrequired

Trip Id

Example: 6926658168

pnrIdstringrequired

Pnr Id

Example: 2643222286

curl -i -X POST \
  https://apis.spotnana.com/v2/trips/6926658168/pnrs/2643222286/download-invoice \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Bodyapplication/json

datastring(byte)

Example: "6935813e12584abda0e43d71cd2ea260"

Response

application/json

{
  "data": "6935813e12584abda0e43d71cd2ea260"
}

Process the PNR approval

Request

Approve or decline a PNR.

Path

pnrIdstringrequired

Pnr Id

Example: 6926658168

Bodyapplication/jsonrequired

approvalIdstring

Serialised Id containing approval related info

Example: "test-approval-id"

approvalTypestringrequired

Approval response APPROVED or DECLINED

Enum"APPROVED""DECLINED"

Example: "APPROVED"

curl -i -X POST \
  https://apis.spotnana.com/v2/pnrs/6926658168/process-approval \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "approvalId": "test-approval-id",
    "approvalType": "APPROVED"
  }'

Responses

Response

No content

PNRs

APIs to manage PNRs within trips.

Invoicing

APIs to manage invoicing.

Operations

Approval

APIs to manage approvals.

Operations