Booking Response

Core Block

Attribute Type Description
search_id String Search ID need to be carried from the search response.
iternary_id String Iternary ID holds multiple bookings.
occupancy Object Refer Occupancy Block.
contact Object Refer Contact Block.
transfer_departure String Refer to the Transfer - Departure and Arrival.
transfer_duration String Transfer Duration time.
pricing Object Refer to the Price details block.
pickup_information String Refer to the Pickup information block.
meeting_point String It is the description about where the Client meet.
description String It is the description about the Shuttles.
cancellation_policies String Refer to the Cancellation Policies block.
booking_reference String It is Required at the time of when you are cancell the OneWay transfers booking.
booking_id String Booking ID will be different at the time of onward and return
GRN-T-201912-002507 & GRN-T-201912-002506
agent_remarks String Remarks are given by the agent.
transfer_return String Refer to the Transfer - Departure and Arrival
agent_reference String Additional Comment by agent.

Contact

Attribute Type Description
title String Title of the Holder Mr./Ms./Mrs.
firstname String Aarav
lastname String Jais
age Number age
client_nationality String Required Two-letter ISO country code of the lead passenger
"IN -Indian"
email String suppliersupport@grnconnect.com
telephone String +919910411117 
{
"contact": {
        "title": "Mr.",
        "firstname": "Aarav",
        "lastname": "Jais",
        "age": "30",
        "client_nationality": "IN",
        "email": "suppliersupport@grnconnect.com",
         "telephone": "+91 11 46504444"
    }
}

Occupancy

Attribute Type Description
adults Integer The number of adults in the vehicle .
children Integer The number of children in the vehicle
Between : 1-11 years
infants Integer The number of infants in the vehicle
Between : 0-1 year		 
{
     "occupancy": {
        "adults": 1,
        "children": 1,
        "infants": 1
    }
}

Transfer - Departure and Arrival

Attribute Type Description
pickup_information Object Refer Pick up Block
pricing Object Refer Price details Block
non_refundable Boolean false/true
cancellation_policies Array List of Cancellation Policies
booking_id String Booking ID
agent_remarks String Agent Remarks given by the agent.

Price Details

Dynamic key-value pairs, where each value is an array of charge details. These details are for display purpose only. A compliant implementation is not required to process or interpret these details.

Name Type Description
name String Name of the charge.
included Boolean true if the charge is already included in the price.
amount_type String Only flat_fee
amount Float flat fee or percentage value.
currency String Three-letter ISO currency code

Pick up Information

Attribute Type Description
transfer_to Object Refer to Location Block
transfer_from Object Refer to Location Block
transfer_time String Pickup Time
transfer_date String Pickup Date
additional_info Object Refer to Additional Info

Transfer_From & Transfer_To

Attribute Type Description
type String Type will dpened on value of the "code" passed in above paramter. Type
air for airport
hotel for hotel_id
GRN Station for station
GRN Port for port
name String Name of the Destination.
code String Airport code(IATA CODE) or
GRN Hotel code or
GRN Station code or
GRN Port code.
All the values of airport code, GRN hotel code, Station code & Port code needs to be fetched from masters files
address String Address of the airport , hotel , Station and Port.

**NOTE : ** Currently the API will supports transfer between airport and hotel. The API supports will not return transfer from airport to airport and hotel to hotel. GRNStation code and GRNPort code will be deployed in second phase

Additional Info

Attribute Type Description
carrier_time String Carrier timeing 10:00:00 format HH:MM:SS 24 hours standard
carrier_date String Carrier date 2020-01-22, format YYYY-MM-DD
carrier_name String Carrier name Flight, Ship or Train Name.
e.g "Indigo or TGV"
carrier_number String Carrier number Flight, Ship or Train Number.
e.g IG-2234 or MCH-879
carrier_terminal String Carrier terminal Name or Number.
e.g Terminal-3
source_airport String Source Airport code(IATA CODE) needs to fetched from Static files.

Error Code

HTTP Status Code Error Code Description

Sample Respone Onward

{
    "search_id": "jjcvagmcq763wy54azmjpmax2a",
    "iternary_id": "GRN-IT-201912-001062",
    "occupancy": {
        "infants": 1,
        "children": 1,
        "adults": 1
    },
    "transfer_return": {
        "transfer_duration": "1:00",
        "pricing": {
            "total": 1483,
            "breakdown": {
                "net": [
                    {
                        "percent": null,
                        "name": "SupplierPrice",
                        "included": true,
                        "currency": "INR",
                        "amount_type": "value",
                        "amount": 1431.35
                    },
                    {
                        "percent": 3,
                        "name": "ServiceFee",
                        "included": true,
                        "currency": "INR",
                        "amount_type": "value",
                        "amount": 42.94
                    },
                    {
                        "percent": null,
                        "name": "Total",
                        "included": true,
                        "currency": "INR",
                        "amount_type": "value",
                        "amount": 1474.29
                    }
                ],
                "GST": [
                    {
                        "percent": 18,
                        "name": "Total",
                        "included": true,
                        "currency": "INR",
                        "amount_type": "value",
                        "amount": 7.73
                    }
                ]
            }
        },
        "pickup_information": {
            "transfer_to": {
                "type": "air",
                "name": "New York - Newark Liberty Airport",
                "code": "EWR",
                "address": "New York - Newark Liberty Airport"
            },
            "transfer_time": "23:35",
            "transfer_from": {
                "type": "hotel",
                "name": "The Lexington Hotel",
                "code": "H!0004970",
                "address": "511 Lexington Avenue, Entrance at 48th Street, New York, New York 10017"
            },
            "transfer_date": "2020-03-08",
            "additional_info": {
                "source_airport": "LGA",
                "carrier_time": "03:05:30",
                "carrier_terminal": "Terminal-1",
                "carrier_number": "09852",
                "carrier_name": "Delta Air Lines",
                "carrier_date": "2020-03-09"
            }
        },
        "non_refundable": false,
        "meeting_point": "\r\n<b>Your transportation is provided by 'Supershuttle' - Identify yourself with the reference: <u>Supershuttle SSV#1823</u><br><br>You MUST confirm your pick up time</b><br>Contact the supplier 48h prior to departure during their office hours. Please mention that you want to book your pick up and that you have a pre-paid 'HolidayTaxis' booking. Make sure that you obtain the Supershuttle confirmation number when given to you.<br><br><b>Ensure that you are at your pick up point 10/15 minutes before the confirmed time</b>. Identify yourself by showing this confirmation to your Supplier, for whom we act as a booking agent.<br><br><u><b>Port pick up</b></u>: Reservations are required before you travel - follow the instrucions above. On arrival, call the supplier when you are ready to be picked up and let them know what pier you are on. SuperShuttle cannot wait inside the port.<br><br>We cannot accept responsibility for missed transfers and/or subsequent missed flights due to non confirmation of pick up times.\r\n\r\n - ",
        "description": "This is a cost effective shared service with other passengers. Shuttles run between the airport and accommodation excluding private address. You will be dropped off/ picked up from your hotel or nearest accessible point. Your transfer time is estimated but may vary dependant on traffic and number of stops made. There may be a wait at the airport or pick up point as buses run to a schedule. Further information on how to locate your transfer and find out your pick-up time can be found on your booking voucher.",
        "cancellation_policies": [
            {
                "under_cancellation": false,
                "details": [
                    {
                        "from": "2020-03-05T16:12:00",
                        "flat_fee": 1483,
                        "currency": "INR"
                    }
                ],
                "cancel_by_date": "2020-03-05T16:11:59",
                "amount_type": "value"
            }
        ],
        "booking_reference": "i4tprhczjmws5lribimvqxsham",
        "booking_id": "GRN-T-201912-002507",
        "agent_remarks": "Please Provide wheelchair"
    },
   "contact": {
        "title": "Mr.",
        "firstname": "Aarav",
        "lastname": "Jais",
        "age": "30",
        "client_nationality": "IN",
        "email": "suppliersupport@grnconnect.com",
         "telephone": "+91 11 46504444"
    },
    "agent_reference": null
}

Sample Respone (Onward & Return)

{
    "search_id": "jjcvagmcq763wy54azmjpmax2a",
    "iternary_id": "GRN-IT-201912-001062",
    "occupancy": {
        "infants": 1,
        "children": 1,
        "adults": 1
    },
    "transfer_departure": {
        "transfer_duration": "1:00",
        "pricing": {
            "total": 1483,
            "breakdown": {
                "net": [
                    {
                        "percent": null,
                        "name": "SupplierPrice",
                        "included": true,
                        "currency": "INR",
                        "amount_type": "value",
                        "amount": 1431.35
                    },
                    {
                        "percent": 3,
                        "name": "ServiceFee",
                        "included": true,
                        "currency": "INR",
                        "amount_type": "value",
                        "amount": 42.94
                    },
                    {
                        "percent": null,
                        "name": "Total",
                        "included": true,
                        "currency": "INR",
                        "amount_type": "value",
                        "amount": 1474.29
                    }
                ],
                "GST": [
                    {
                        "percent": 18,
                        "name": "Total",
                        "included": true,
                        "currency": "INR",
                        "amount_type": "value",
                        "amount": 7.73
                    }
                ]
            }
        },
        "pickup_information": {
            "transfer_to": {
                "type": "hotel",
                "name": "The Lexington Hotel",
                "code": "H!0004970",
                "address": "511 Lexington Avenue, Entrance at 48th Street, New York, New York 10017"
            },
            "transfer_time": "09:10",
            "transfer_from": {
                "type": "air",
                "name": "New York - Newark Liberty Airport",
                "code": "EWR",
                "address": "New York - Newark Liberty Airport"
            },
            "transfer_date": "2020-03-06",
            "additional_info": {
                "source_airport": "LGA",
                "carrier_time": "09:10:00",
                "carrier_terminal": "Terminal-1",
                "carrier_number": "09852",
                "carrier_name": "Delta Air Lines",
                "carrier_date": "2020-03-06"
            }
        },
        "non_refundable": false,
        "meeting_point": "\r\n<b>Your transportation is provided by 'Supershuttle' - Identify yourself with the reference: <u>Supershuttle SSV#1823</u></b><br><b><br>LOCATING YOUR TRANSFER</b><br>Follow the signs to the <u>Welcome Center / Ground Transportation Desk</u> located outside of the Baggage Claim area. You must show your voucher to one of the agents. Alternatively, you can call SuperShuttle from the courtesy phone next to the Welcome Center Desk.<br><b><br>THIS SERVICE IS ONLY PROVIDED UPON PRESENTATION OF YOUR BOOKING VOUCHER AND IS NOT PREBOOKED.</b><br><br><u><b>IMPORTANT</b></u>: Please ensure that you have printed 2 copies of your voucher (one for arrival/one for departure) as your voucher will be collected by your driver on arrival.<br><br><b>DIFFICULTY IN LOCATING YOUR TRANSFER</b><br>Contact your Supplier for assistance. Do not leave without having contacted the Supplier first.\r\n\r\n - ",
        "description": "This is a cost effective shared service with other passengers. Shuttles run between the airport and accommodation excluding private address. You will be dropped off/ picked up from your hotel or nearest accessible point. Your transfer time is estimated but may vary dependant on traffic and number of stops made. There may be a wait at the airport or pick up point as buses run to a schedule. Further information on how to locate your transfer and find out your pick-up time can be found on your booking voucher.",
        "cancellation_policies": [
            {
                "under_cancellation": false,
                "details": [
                    {
                        "from": "2020-03-02T12:06:00",
                        "flat_fee": 1483,
                        "currency": "INR"
                    }
                ],
                "cancel_by_date": "2020-03-02T12:05:59",
                "amount_type": "value"
            }
        ],
        "booking_reference": "dxilovt2bnikpvgrruf6zetwmq",
        "booking_id": "GRN-T-201912-002506",
        "agent_remarks": "Please Provide wheelchair"
    },
    "transfer_return": {
        "transfer_duration": "1:00",
        "pricing": {
            "total": 1483,
            "breakdown": {
                "net": [
                    {
                        "percent": null,
                        "name": "SupplierPrice",
                        "included": true,
                        "currency": "INR",
                        "amount_type": "value",
                        "amount": 1431.35
                    },
                    {
                        "percent": 3,
                        "name": "ServiceFee",
                        "included": true,
                        "currency": "INR",
                        "amount_type": "value",
                        "amount": 42.94
                    },
                    {
                        "percent": null,
                        "name": "Total",
                        "included": true,
                        "currency": "INR",
                        "amount_type": "value",
                        "amount": 1474.29
                    }
                ],
                "GST": [
                    {
                        "percent": 18,
                        "name": "Total",
                        "included": true,
                        "currency": "INR",
                        "amount_type": "value",
                        "amount": 7.73
                    }
                ]
            }
        },
        "pickup_information": {
            "transfer_to": {
                "type": "air",
                "name": "New York - Newark Liberty Airport",
                "code": "EWR",
                "address": "New York - Newark Liberty Airport"
            },
            "transfer_time": "23:35",
            "transfer_from": {
                "type": "hotel",
                "name": "The Lexington Hotel",
                "code": "H!0004970",
                "address": "511 Lexington Avenue, Entrance at 48th Street, New York, New York 10017"
            },
            "transfer_date": "2020-03-08",
            "additional_info": {
                "source_airport": "LGA",
                "carrier_time": "03:05:30",
                "carrier_terminal": "Terminal-1",
                "carrier_number": "09852",
                "carrier_name": "Delta Air Lines",
                "carrier_date": "2020-03-09"
            }
        },
        "non_refundable": false,
        "meeting_point": "\r\n<b>Your transportation is provided by 'Supershuttle' - Identify yourself with the reference: <u>Supershuttle SSV#1823</u><br><br>You MUST confirm your pick up time</b><br>Contact the supplier 48h prior to departure during their office hours. Please mention that you want to book your pick up and that you have a pre-paid 'HolidayTaxis' booking. Make sure that you obtain the Supershuttle confirmation number when given to you.<br><br><b>Ensure that you are at your pick up point 10/15 minutes before the confirmed time</b>. Identify yourself by showing this confirmation to your Supplier, for whom we act as a booking agent.<br><br><u><b>Port pick up</b></u>: Reservations are required before you travel - follow the instrucions above. On arrival, call the supplier when you are ready to be picked up and let them know what pier you are on. SuperShuttle cannot wait inside the port.<br><br>We cannot accept responsibility for missed transfers and/or subsequent missed flights due to non confirmation of pick up times.\r\n\r\n - ",
        "description": "This is a cost effective shared service with other passengers. Shuttles run between the airport and accommodation excluding private address. You will be dropped off/ picked up from your hotel or nearest accessible point. Your transfer time is estimated but may vary dependant on traffic and number of stops made. There may be a wait at the airport or pick up point as buses run to a schedule. Further information on how to locate your transfer and find out your pick-up time can be found on your booking voucher.",
        "cancellation_policies": [
            {
                "under_cancellation": false,
                "details": [
                    {
                        "from": "2020-03-05T16:12:00",
                        "flat_fee": 1483,
                        "currency": "INR"
                    }
                ],
                "cancel_by_date": "2020-03-05T16:11:59",
                "amount_type": "value"
            }
        ],
        "booking_reference": "i4tprhczjmws5lribimvqxsham",
        "booking_id": "GRN-T-201912-002507",
        "agent_remarks": "Please Provide wheelchair"
    },
    "contact": {
        "title": "Mr.",
        "firstname": "Aarav",
        "lastname": "Jais",
        "age": "30",
        "client_nationality": "IN",
        "email": "suppliersupport@grnconnect.com",
         "telephone": "+91 11 46504444"
    }
    "agent_reference": null
}