If you don’t recognize the user in your application, then yes, you need to create a new traveler using Milefy API.
Once traveler is created, you can store its ID and use for any future calculations or to personalize its profile with assigned frequent flyer memberships. Traveler ID can be stored as a part of user account data in your database. In case user haven’t created any account in your application, you can use browser cookie or localStorage to store traveler ID and re-use in the next session.
Note, that you can create a traveler only since version 3.0 Milefy API.
First of all, check the documentation and make sure you have specified all required parameters in your request. Then you may check if your requests are authenticated (ether by provided API key or with HTTP basic authentication). Finally make sure you are using right base URL, correct endpoint and you set all request heeaders properly (such as version of API).
If you’ve checked above and still you have problems to get things work, then contact us, we will try our best to help you.
In general, there are three basic types of miles with different types of application for the consumer to earn:
Redeemable Miles, also known as Award Miles, function as currency in the sense that the traveler accumulates RDM in order to redeem them for goods and services. The most common redemption is for free flights or upgrades to a higher cabin class when flying, but RDM can also be redeemed for other products, such as shopping, dining, hotels, rental cars and more, depending on your frequent flyer program.
RDM are earned from flying and the amount is typically a factor of the flown distance expressed in nautical miles. The factor is set by the program and depends on restrictions of a fare. A common rule is that the cheaper a fare is, the more restrictions apply. If the program grants varying factors for the accruals of miles, the cheaper fares will also grant a lower factor. A booking code is a single letter that indicates the specific restrictions of the fare paid.
Here’s an example of mileage earnings:
If we apply the above rule to an example of a flight across 1,000 miles, the passenger that purchased a K-fare will earn 500 miles, whereas the passenger that bought a B-fare earns the full 1,000 miles.
There are also rules for whether the miles earned apply to the airline that is marketing the flight or the airline that is actually operating the flight.
Elite Qualifying Miles also known as Status Miles can only be earned from flying. They count for a traveler’s status with the airline and the recognition he gets for his loyalty. These miles are not redeemable but the user instead receives various benefits when he or she is travelling. The most common ones are: priority check-in, priority boarding, airport lounge access, extra baggage allowance, complimentary travel class upgrades, amongst others.
There are several status levels that grant different types of benefits. After earning a sufficient amount of status miles, the traveler earns a higher status tier or level. EQM come in a variety of forms but the most typical allows for a factor to be applied to the actual flown distance (in nautical miles). As an example, the various status tiers may look like this:
Once a threshold is reached, the traveler gains the new status level and the benefits that are associated with it. For instance, if a traveler flies a B-fare that earns him 100% EQM, and takes a trip that spans 10,000 miles three times in a year, he has earned 30,000 EQM and has passed the Silver threshold.
Status levels oftentimes also earn a traveler an RDM bonus. For instance, a “Premier Silver” status member with United Airlines’ MileagePlus program earns a 25% RDM bonus for qualifying booking. (Note that the earning factors for RDM and EQM may differ, for instance, a K-fare may earn 50% RDM but 100% EQM, or vice versa, etc.)
Some frequent flyer programs have systems based on other criteria. Examples include a fixed amount of “points” or similar for each flight, and a traveler needs to reach a specific threshold of points in order to earn tier status.
A traveler will hold a status level with an airline for a limited amount of time. This varies across airlines but the most common limit is until the end of the following calendar year. Thereafter a traveler needs to requalify for the status by again fulfilling the requirements for status.
A brief example is a flyer that earns 50,000 EQM in July, Year 0. He receives Gold status instantly and enjoys it throughout Year 0, but also throughout Year 1. During Year 1, however, he is required to earn at least 50,000 EQM again if he wants to keep the Gold status in Year 2. The same applies to the traveler that earned 50,000 EQM already in January, Year 0, or the traveler that earned 50,000 EQM in December, Year 0. The requirement to requalify for status for Year 2, is that at the beginning of each new year, the EQM is reset to 0 and the traveler needs to start from scratch again. In other words, the perks are time specific and loyalty needs to be continuous.
Besides EQM, a traveler can also earn status based on the number of segments he flies within the earning time period. A segment is considered a takeoff and landing pair. An example would be a flight that goes directly from New York to Los Angeles without stopping. Given that there is only one takeoff and one landing, that flight equals 1 segment. If that itinerary instead includes a layover in Denver before heading onwards in Los Angeles, it has two takeoffs and landings, equaling 2 segments.
EQS are relevant for the travelers that travel often on the same airline, but only short distances, for instance New York to Boston. These travelers are loyal to an airline but would find it difficult to earn tier status based on miles flown so the airline rewards them by giving status for the number of flights taken rather than the distance flown (EQM).
In most of cases 401 HTTP error indicates, that you are not authorized to use our API.
Since Milefy 3.0 version you need to add query string parameter apiKey
with the individual API key, that we issue for every client e.g. https://milefy-api.30k.com/travelers?apiKey=YOUR_API_KEY
If you are using elder version of Milefy API or Wallet API, then you need to use basic HTTP authentication, e.i. specify Authorization
header with username and password, that has been issued for you.
If you haven’t received neither apiKey
nor credentials for HTTP basic authentication, then contact us.
Wallet allows to manage traveler frequent flyer program memberships. For example:
Wallet can also be used to personalize frequent flyer data returned for flights such as: mileage earnings, status benefits and cabin upgrades.
Since 3.0 version of Milefy API, standalone Wallet API become obsolete and its functionality has become an integral part of Milefy API.
The testing environment is to be used as an endpoint for initial API tests and integrations. It is always slower than live environment, but should be fast enough to build your application with our API integrated and prove the concept. It is free of charge as well.
Once integration is finalized and we verify it, then you will be granted access to our live environment and we will start counting your every request and charge for it.
Also worth to mention that all new features and additions to our API are being usually delivered to testing environment first so our customers can get prepared to these changes in advance.
Short answer: vast majority.
Long answer:
There are only a few programs, that can’t be authenticated with user credentials. Users can still add these programs to their membership list, but they can’t sync and update their mileage balances automatically. It affects programs of major American carriers such as: American Airlines AAdvantage, Delta Skymiles and United MileagePlus.