# Get Loyalty Programs (Air)

Returns all the active loyalty programs for the requested marketing and/or operating airlines.

Endpoint: GET /v2/air/loyalty-programs
Version: v2
Security: Bearer

## Query parameters:

  - `marketingAirline` (string)
    IATA code of the marketing airline for which the loyalty programs need to be fetched.
    Example: "AA"

  - `operatingAirline` (string)
    IATA code of the operating airline for which the loyalty programs need to be fetched.
    Example: "BA"

  - `travelerId` (string)
    User ID of the traveler.
    Example: "4974a66b-7493-4f41-908c-58ba81093947"

  - `travelArrangerId` (string)
    User ID of the travel arranger.
    Example: "4974a66b-7493-4f41-908c-58ba81093947"

## Response 200 fields (application/json):

  - `loyaltyPrograms` (array, required)

  - `loyaltyPrograms.programName` (string, required)
    Name of the loyalty program.
    Example: "AA Advantage"

  - `loyaltyPrograms.airlineCode` (string, required)
    IATA code of the airline that hosts the loyalty program.
    Example: "AA"

  - `loyaltyPrograms.airlineName` (string, required)
    Name of the airline that hosts the loyalty program.
    Example: "American Airlines"

  - `loyaltyPrograms.loyaltyType` (string, required)
    Type of the loyalty program. This indicates how the loyalty program is associated with the airline mentioned in the API request.
    Enum: "OWN", "PARTNER", "ALLIANCE"

  - `applicableLoyalties` (array)

  - `applicableLoyalties.appliedTo` (array)
    Example: ["TAJ"]

  - `applicableLoyalties.id` (string, required)
    Example: "firstId"

  - `applicableLoyalties.issuedBy` (string, required)
    Example: "firstIssuedBy"

  - `applicableLoyalties.type` (string, required)
    Enum: "UNKNOWN_TYPE", "AIR", "HOTEL", "CAR", "RAIL"

  - `applicableLoyalties.linked` (boolean)
    Indicates if this loyalty account is linked to the external provider. Only applicable for certain loyalty types.

## Response 401 fields (application/json):

  - `debugIdentifier` (string)
    Link to debug the error internally.

  - `errorMessages` (array)

  - `errorMessages.errorCode` (string)
    Error code to identify the specific errors.

  - `errorMessages.message` (string)
    Message containing details of error.

  - `errorMessages.errorParameters` (array)
    Error message parameters.

  - `errorMessages.errorParameters.name` (string)
    Parameter name

  - `errorMessages.errorParameters.value` (string)
    Parameter value

  - `errorMessages.errorDetail` (string)
    More details about the error.

## Response 403 fields (application/json):

  - `debugIdentifier` (string)
    Link to debug the error internally.

  - `errorMessages` (array)

  - `errorMessages.errorCode` (string)
    Error code to identify the specific errors.

  - `errorMessages.message` (string)
    Message containing details of error.

  - `errorMessages.errorParameters` (array)
    Error message parameters.

  - `errorMessages.errorParameters.name` (string)
    Parameter name

  - `errorMessages.errorParameters.value` (string)
    Parameter value

  - `errorMessages.errorDetail` (string)
    More details about the error.

## Response 404 fields (application/json):

  - `debugIdentifier` (string)
    Link to debug the error internally.

  - `errorMessages` (array)

  - `errorMessages.errorCode` (string)
    Error code to identify the specific errors.

  - `errorMessages.message` (string)
    Message containing details of error.

  - `errorMessages.errorParameters` (array)
    Error message parameters.

  - `errorMessages.errorParameters.name` (string)
    Parameter name

  - `errorMessages.errorParameters.value` (string)
    Parameter value

  - `errorMessages.errorDetail` (string)
    More details about the error.