NAV Navbar
  • Introduction
  • Authentication
  • API
  • About
  • Introduction

    API Endpoint Version 4

    Welcome to the EasyPNR API v4 documentation! Following the further instructions you will be able to decode Amadeus, Sabre and Travelport PNR directly on your application.

    The EasyPNR API is a REST Server available at the endpoint

    The API is pretty simple, anyway, in case of problems, contact us on or using the form available on the website.

    Subscribe to EasyPNR Web service newsletter to be notified about new features and releases.

    What's new in Version 4?

    Older versions

    The Protocol Version 3 documentation can be found here


    To use the Web Services, you must pass your API Token on all requests:

    # Example of a request using an API Key
    curl -i -X POST -h "X-Api-Key: mySecretKey"

    To use the Web Services, you must have an active account on the and obtain your API Key on My account page.

    Once you have your API Key, you must use it in all Web Service calls, passing your key in an HTTP Header named "X-Api-Key".

    Be careful and keep your API Key secret. Do not share your secret API keys in publicly accessible areas such GitHub, client-side code, and so forth.



    curl -i -X POST -H "X-Api-Key: mySecretKey" \
     -d $'1.JOHNSON/BRIAN MR  2.JOHNSON/BRENDA MRS                             
       2  EK 262 Y 08MAR 6 GRUDXB HK1       2  0125 2255   77W E 0 M               
          ADD ADVANCE PASSENGER INFORMATION IN SSR DOCS                            
          ADD SSR PCTC TO PROVIDE PAX CONTACT                                      
          SEE RTSVC                                                                
       4 TRN 2C  87    6628 AF 26NOV 4 FRLPD FRPLY HK1   1800  2007                 
       5 HTL 1A HK4 CVF 30NOV-01DEC/HOTEL LES ANCOLIES/RUE DES                      
           GRAVELLES 73120 COURCHEVEL/T-                     
       ' \
     -H "Content-Type: application/json"
      "persons": [
          "firstName": "BRIAN",
          "lastName": "JOHNSON",
          "title": "MR",
          "rawData": "JOHNSON/BRIAN MR"
          "firstName": "BRENDA",
          "lastName": "JOHNSON",
          "title": "MRS",
          "rawData": "JOHNSON/BRENDA MRS"
      "flightInfo": {
        "flights": [
            "company": {
              "iataCode": "EK",
              "description": "Emirates"
            "departureTime": "2018-03-08 01:25:00",
            "landingTime": "2018-03-08 22:55:00",
            "flight": "262",
            "departureAirport": {
              "iataCode": "GRU",
              "description": "Guarulhos International Airport - Guarulhos, São Paulo, Brazil"
            "extraInfo": {},
            "seatInfo": [],
            "landingAirport": {
              "iataCode": "DXB",
              "description": "Dubai International Airport - Dubai, United Arab Emirates"
        "extraInfo": null
      "hotelInfo": {
        "hotels": [
            "extraInfo": null,
            "name": "HOTEL LES ANCOLIES",
            "address": "RUE DES GRAVELLES 73120 COURCHEVEL",
            "checkIn": "2017-11-30",
            "checkOut": "2017-12-01"
        "extraInfo": null
      "trainInfo": {
        "extraInfo": null,
        "trains": [
            "departureTime": "2017-11-26 18:00",
            "arrivingTime": "2017-11-26 20:07",
            "departureStationCode": "FRLPD",
            "arrivingStationCode": "FRPLY",
            "number": "6628"
        "stationNames": {
          "FRLPD": "LYON PART DIEU",
          "FRPLY": "PARIS GARE LYON"
      "extraInfo": null


    Decode a PNR.

    At the BODY of the POST submit your encoded PNR as plain text.


    Methods to retrieve airport data.

    curl -i -X GET -H "X-Api-Key: mySecretKey"
        "locationName": "Hercílio Luz International Airport",
        "location": "Florianópolis, Santa Catarina",
        "country": "Brazil",
        "iataCode": "FLN"
    Method Path Description Parameters
    GET /airports Retrieve all airports with details.
    GET /airports/:iataCode Retrieve details of an airport. The airport IATA code


    # Request
    curl -i -X GET -H "X-Api-Key: mySecretKey"
    pong 1478969148631
    Method Path Description Parameters
    GET /ping Ping the server


    EasyPNR is a free decoder and formatter for Amadeus, Sabre and Travelport.