# Priceless Specials Api
source: https://developer.mastercard.com/priceless-specials/documentation/tutorials-and-guides/priceless-specials-api-tutorial/index.md

## Summary {#summary}

The table below describes each API component and its usage:

|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| #### API Name      | #### Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Offer              | Returns a list of offers with offer information, merchant information and images for each offer. Offers can be filtered and sorted by using the input parameters. The parameters can be combined for advanced filtering and sorting operations. Offers contained in Priceless Specials are largely based on discounts off experiences. Example: One for one dinning offers, 10% off day tours.                                                                                         |
| Benefit            | Return a list of benefit information, related merchant information and images for each benefit. Benefits can be filtered and sorted by using parameters. The parameters can be combined for advanced filtering and sorting operations. Benefits are not based on discounts, but perks that are available for Mastercard cardholders. This includes insurance benefits or lounge access. Please note that benefits differ base on card tiers, and may not be opened to all cardholders. |
| Language           | Returns a list of languages which are available in the Priceless Specials system in BCP-47 format.                                                                                                                                                                                                                                                                                                                                                                                     |
| Merchant           | Returns a list of merchant with merchant information. Merchants can be filtered by using the input parameters.                                                                                                                                                                                                                                                                                                                                                                         |
| Card Products      | Returns a list of Product (Card) based on combination of filter and client_ID.                                                                                                                                                                                                                                                                                                                                                                                                         |
| Category           | Returns a list of Category which is applicable in the Priceless Specials system in specified language.                                                                                                                                                                                                                                                                                                                                                                                 |
| Country            | Returns a list of countries which is applicable in the Priceless Specials system in specified language.                                                                                                                                                                                                                                                                                                                                                                                |
| Mastercard Product | Returns a list of Mastercard Product name in specified language.                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Program            | Returns a list of Program with Program information.                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Tag                | Returns a list of tag, with tag's ID and name.                                                                                                                                                                                                                                                                                                                                                                                                                                         |

## Step 3: Download Insomnia an approved API Platform for interacting with all Mastercard APIs {#step-3-download-insomnia-an-approved-api-platform-for-interacting-with-all-mastercard-apis}

**Quick Setup**

A step by step guide to setting up Insomnia for Mastercard APIs can be found here:

<https://developer.mastercard.com/tutorial/use-insomnia-rest-client-for-mastercard-apis?lang=#overview>

The insomnia plugin referenced in the above guide will allow you to quickly add the authentication header for Mastercard APIs without any prior setup. It is currently still experimental, hence please reach out to [apisupport@mastercard.com](mailto:apisupport@mastercard.com) for the plugin or for technical support if you encounter any gateway level errors.

**Access sandbox with the keys generated in step 1, to experiment with 'dummy data'.**

The Auth header will be generated when the following environment variable "Mastercard" is set. You can create multiple Environments in your Workspace to store different configurations. Create one for Sandbox and one for Production to have them store different key information. Here is an example template for the sandbox environment variable with placeholder values:

![](https://static.developer.mastercard.com/content/priceless-specials/uploads/6666.png)

The environment variable **host** helps us keep the value of the base URL of our Mastercard API endpoints:

\| Environment \| Host \|

|  Sandbox   | <https://sandbox.api.mastercard.com> |
|------------|--------------------------------------|
| Production | <https://api.mastercard.com>         |

We can then complete the URL to Priceless Specials with the path: "{{host}}/priceless/specials/v1" in the request. Please refer to the Priceless Specials Swagger for the full specifications.