Skip to content
API reference
/
/Credits

Air API (v2)

Download OpenAPI description
AirApi.json
AirApi.yaml
Languages
Servers
Sandbox URL
https://api-ext-sboxmeta.partners.spotnana.com/
Spotnana mock server
https://developer.spotnana.com/_mock/openapi/airapi/

Air

APIs to perform search, checkout and book an air pnr

Operations

Credits

Manage airline credits including company credit pools, credit transfers, and credit redemptions.

Operations

Get unused credits for a traveler

Request

Returns a list of unused credits associated with a traveler along with details such as the PNR ID, trip ID, airline details, credit expiry date, and the source of booking (e.g., NDC). Travelers can redeem unused credit for future bookings with the same airline where the credit was earned.

Security
Bearer
Bodyapplication/jsonrequired
travelerInfoUserIdWrapper (object) or AdhocTravelerInfoWrapper (object)(AirRequestTravelerInfo)required
One of:

Traveler information to get userOrgId.

travelerInfo.​userIdobject(UserId)

User identifier

curl -i -X POST \
  https://api-ext-sboxmeta.partners.spotnana.com/v3/air/fetch-traveler-unused-credits \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "travelerInfo": {
      "userId": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      }
    }
  }'

Responses

OK

Bodyapplication/json
unusedCreditInfoArray of objects(UnusedCreditInfo)
Response
application/json
{
  "unusedCreditInfo": [
    { … }
  ]
}

Get unused credits for a company

Request

Returns the list of company unused credits which can be used by any employees of the company.

Security
Bearer
Bodyapplication/jsonrequired
companyIdobject
companyCreditFilterobject(CompanyCreditFilter)

Filter for fetching company credits.

offsetinteger>= 0
Example: 0
curl -i -X POST \
  https://api-ext-sboxmeta.partners.spotnana.com/v3/air/company-unused-credits/list \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "companyId": {
      "id": "edd5b835-8001-430c-98f8-fedeccebe4cf"
    },
    "companyCreditFilter": {
      "supplier": "SABRE",
      "selectedAirlines": [
        "AA"
      ],
      "expiryDateRange": {
        "expiryDateStart": {
          "iso8601": "2017-07-21"
        },
        "expiryDateEnd": {
          "iso8601": "2017-07-21"
        }
      },
      "fopLabel": [
        "Company Central Card",
        "Personal Card"
      ],
      "pcc": "LA5K"
    },
    "offset": 0
  }'

Responses

OK

Bodyapplication/json
unusedCreditInfosArray of objects(UnusedCreditInfo)
paginationParamsobject
companyFopLabelsArray of strings

List of distinct FOP labels for company credits

Example: ["Company Central Card","Corporate Amex"]
Response
application/json
{
  "unusedCreditInfos": [
    { … }
  ],
  "paginationParams": {
    "offset": 0,
    "totalRecords": 100
  },
  "companyFopLabels": [
    "Company Central Card",
    "Corporate Amex"
  ]
}

Get transferable unused credits for a company

Request

Returns the list of transferable company unused credits which can be used by any employees of the company. The unused credits can be transferred to another traveler.

Security
Bearer
Bodyapplication/jsonrequired
companyIdobjectrequired
companyId.​idstring(uuid)required
Example: "edd5b835-8001-430c-98f8-fedeccebe4cf"
companyCreditFilterobject(CompanyCreditFilter)

Filter for fetching company credits.

offsetinteger>= 0
Default 0
Example: 0
curl -i -X POST \
  https://api-ext-sboxmeta.partners.spotnana.com/v3/air/company-transferable-unused-credits/list \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "companyId": {
      "id": "edd5b835-8001-430c-98f8-fedeccebe4cf"
    },
    "companyCreditFilter": {
      "supplier": "SABRE",
      "selectedAirlines": [
        "AA"
      ],
      "expiryDateRange": {
        "expiryDateStart": {
          "iso8601": "2017-07-21"
        },
        "expiryDateEnd": {
          "iso8601": "2017-07-21"
        }
      },
      "fopLabel": [
        "Company Central Card",
        "Personal Card"
      ],
      "pcc": "LA5K"
    },
    "offset": 0
  }'

Responses

OK

Bodyapplication/json
unusedCreditInfosArray of objects(UnusedCreditInfo)
paginationParamsobject
companyTransferableFopLabelsArray of strings

List of distinct FOP labels for company transferable credits

Example: ["Personal Visa","Personal Mastercard"]
Response
application/json
{
  "unusedCreditInfos": [
    { … }
  ],
  "paginationParams": {
    "offset": 0,
    "totalRecords": 100
  },
  "companyTransferableFopLabels": [
    "Personal Visa",
    "Personal Mastercard"
  ]
}

Migrate Unused Credits of a traveler to and fro Company Credits

Request

This API will be migrate unused credits from individual credits to company credits and vice versa.

Security
Bearer
Bodyapplication/jsonrequired
paymentSourceIdsArray of stringsrequired
updateCreditUsageTypeTostring(CreditUsageType)required

The type of credit usage to be updated to. This can be either COMPANY or PERSONAL. If passed Company, it means you are trying to update from personal to Company

Enum"CREDIT_USAGE_TYPE_UNKNOWN""COMPANY""PERSONAL"
curl -i -X POST \
  https://api-ext-sboxmeta.partners.spotnana.com/v3/air/company-credits/migrations \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "paymentSourceIds": [
      "string"
    ],
    "updateCreditUsageTypeTo": "CREDIT_USAGE_TYPE_UNKNOWN"
  }'

Responses

OK

Bodyapplication/json
migrationStatusArray of objects(MigrationResponseInfo)
Response
application/json
{
  "migrationStatus": [
    { … }
  ]
}

Autocomplete

Operations

Loyalty Programs

Operations
Copyright © 2025 Spotnana Technology, Inc.