API reference

Trip

Get PNR by external Id

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 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"
}

Process the PNR approval

Request

This endpoint process a PNR approval to approved or declined

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

Invoicing

Operations

Approval

Operations