Get started

                API Endpoint

                https://api.magrgroup.com/api/
            

This documentation is for the Meet and Greet B2B API, which allows users to retrieve information about airport parking options.

To use this API, you need to have a registered account and an API key. Please contact us at alismartin@meetandgreetreservations.co.uk to get your own API key.

This API uses a REST interface with data formatted in JSON.

Each request must include authentication details, registered email as user, API secret key and action parameter in the request body.

Get Parking Quotes

            # CURL example
            curl \
            -X POST https://api.magrgroup.com/api/products/ \
            -H 'Content-Type: application/json' \
            -H 'Cache-Control: no-cache' \
            -d '{
                "user_email": "registered@emailaddress.com",
                "agent_code": "secret-hash-key",
                "password": "wkiskw:w1 (etc)",
                "quote": {
                    "airport_code": "LHR",
                    "dropoff_date": "2023-12-01",
                    "dropoff_time": "10:00",
                    "pickup_date": "2023-12-10",
                    "pickup_time": "20:00",
                }
            }'
            
             
                

To get parking quote products available at specified airports, need to make a POST call to the following Endpoint :
https://api.magrgroup.com/api/products

Result example :

 "request": {
        "status": "success",
        "airport": "LHR",
        "arrival_date": "2025-04-29",
        "arrival_time": "09:00",
        "depart_date": "2025-04-23",
        "depart_time": "12:00"
    },
     
    "products": [
      
        {
            "companyID": 675,
            "product_code": "HAPS-001",
            "opening_time": "00:00",
            "closing_time": "00:00",
            "name": "Heathrow Airport Parking Service - Meet & Greet",
            "processtime": "1",
            "special_features": "CCTV,DISABILITY FRIENDLY,FENCING,PATROLLED,SECURITY LIGHTING",
            "share_percentage": "22",
            "bookingemail": "mzt646@qmechanicspk.com",
            "terms": null,
            "extra_charges": "0",
            "parking_type": "Meet and Greet",
            "logo": "https://dashboard.magrgroup.com/storage/app/companies/S3XatB3IRZgjP9Xi3VgoVNY9zmooGOU0stjIXoyl.png",
            "cancelable": "Yes",
            "editable": "Yes",
            "after_30_days": 3,
            "price": "55.99",
            "overview": "Essentials\n\nEstimated journey time to the airport: Drop at the terminal\nYour
keys will stay in the car park whilst you are away.\nDisability Friendly\n\n
Overview:\nOpt for Heathrow Airport Parking Service Meet and Greet Super Saver for an efficient and discover the seamless parking experience with our Meet and Greet service – the hassle-free solution for business travellers and families. No more waiting at the airport, no terminal transfer worries, and no more shuttle buses, making it the perfect choice to save up to 35 minutes on your journey time. ",
            "return_proc": "Terminal 1\nPostcode: (TW6 1AP)\nClosed for renovation.\nTerminal 2\nPostcode: (TW6 1EW)\nDeparture:\nFrom the M4 exit follow the signs for Terminals 1, 2 & 3 all the way round following onto the Western Perimeter Road. Go through the main tunnel to the Central Terminal Area for Terminals 1, 2 & 3. Exiting the tunnel keep right passing the Central Bus Station joining the final approaches to Terminal 2 on Cosmopolitan Way.  .\nArrival:\nOnce you have collected your luggage and are about to clear customs, call the number given when your car was collected. Make your way to the same place where you dropped the vehicle off Level 4 short stay car park, row R or S.",
            "arrival": "Note: Please ensure you contact this number, 0208 050 3364, at least 30 minutes prior to arrival.\nTerminal 1\nPostcode: (TW6 1AP)\nClosed for renovation.\nTerminal 2\nPostcode: (TW6 1EW)\nDeparture:\nFrom the M4 exit follow the signs for Terminals 1, 2 & 3 all the way round following onto the Western Perimeter Road. Go through the main tunnel to the Central Terminal Area for Terminals 1, 2 & 3. Exiting the tunnel keep right passing the Central Bus Station joining the final approaches to Terminal 2 on Cosmopolitan Way. Again keep right as the road to Terminal 2 will move away from building, before turning back as the road ramps up to Terminal 2 Departures & the Short Stay 2 car park on Constellation Way. On the rising ramp continue to keep right as the ramp will lead directly into the Short stay car park entry barriers. Take the barrier ticket and enter the car park.  "
            "id": 1150,
            "admin_id": 101,
            "facilities": "Pick up at the Airport, Fully Insured Mature Driver's, 6 Miles from airport, Hassle free & convenient, Serving all terminals of Heathrow",
            "park_api": "b2b"
        },
                

QUERY PARAMETERS

Field	Type	Description
user_email	String	Registered email address.
password	String	Your login password.
agent_code	String	Your Secret Agent Code key.
airport	String	IATA Airport codes. e.g LGW, LHR:
depdate	String	Departure Date in YYYY-MM-DD format 1999-01-21.
deptime	String	Departure Time in H:i format 10:00.
returndate	String	Return Date in YYYY-MM-DD format 1999-01-27.
returntime	String	Return Time in H:i format 20:00.

RESPONSE PARAMETERS

Field	Type	Description
status	String	Indicates the status of the API response. In this case, 'success' denotes a successful response.
airport	String	IATA Airport codes. e.g LGW, LHR
products	String	This is an array where each object represents a different parking product. The objects within this array contain the following field.
companyID	String	The Stock Keeping Unit or ID for the parking product. This is a unique identifier for each product.
product_code	String	The Stock Keeping Unit or Product code for the parking product. This is a unique identifier for each product.
name	String	Name of the parking product.
bookingemail	String	email for confirmation. (apibookings@api.magrgroup.com)
price	String	The quoted price for the parking product, a numerical value (such as "75.00"), which indicates the cost of the parking
share_percentage	String	The commission percentage for the product..
facilities	String	parking product facilities given by company.
park_api	String	its define its B2B product.
logo	String	HTML string containing an image tag for the product's logo.
parking_type	String	Indicates the type of service offered. Meet & Greet Or Park & Ride
cancelable	String	Yes Indicates if the booking is flexible, No is non-flexiable
editable	String	Yes Indicates if the booking is editable, No is non-editable
overview	String	A detailed overview of the product, including benefits and features
arival	String	A detailed departure procedures including HTML for formatting.
return_proc	String	Detailed arrival procedures including HTML for formatting.
special_features	String	unique services from airport.
processtime	String	Minimum number of hours required for booking.
opening_time	String	time of company opening time.
closing_time	String	time of company closing time.

Booking / Payment Process

            # CURL example
            curl \
            -X POST https://api.magrgroup.com/api/bookings/ \
            -H 'Content-Type: application/json' \
            -H 'Cache-Control: no-cache' \
            -d '{
                "company_code" => "HAPS-001"
                "bookreference" => "CDC-012504222077"
                "dropoff_time" => "09:00"
                "dropoff_date" => "2025-04-24"
                "pickup_time" => "09:00"
                "pickup_date" => "2025-04-29"
                "title" => "Mr"
                "first_name" => "test"
                "last_name" => "test"
                "customer_email" => "b2b@meetandgreetparkingdeals.com"
                "phone_number" => "23433323"
                "departure_flight_number" => "TBA"
                "arrival_flight_number" => "test"
                "departure_terminal" => "Terminal 2"
                "arrival_terminal" => "Terminal 3"
                "car_registration_number" => "test"
                "car_make" => "test"
                "car_model" => "test"
                "car_color" => "test"
                "park_api" => "b2b"
                "passenger" => 1
                "paymentgateway" => "Invoice"
                "payment_token" => "pi_3RGghGL3PGdUbgCn0UtqdIj3"
                "booking_amount" => 50.99
                "agent_code" => "Ic5w0rP2kWu4M5DVDUztZH6tYqPb"
                "username" => "demob2b"
                "password" => "1234"
            }'
            
             
                

The JSON object outlined below represents the request payload structure for initiating a booking and processing a payment via the API. This section will detail each field within the object to provide a clear understanding of the data required for a successful API request., need to make a POST call to the following Endpoint : bookings/
https://api.magrgroup.com/api/bookings

JSON BOOKING POST DATA PARAMETERS

Field	Type	Description
agent_code	String	Your secret agent code used for authentication.
user_email	String	User Email of the booking partner or agent.
password	String	Password of the booking partner or agent.
company_code	String	Unique code assigned to the parking company.
bookreference	String	Unique booking reference for the transaction.
dropoff_time	String	Scheduled time for vehicle drop-off (format: H:i).
dropoff_date	String	Scheduled date for vehicle drop-off (format: YYYY-MM-DD).
pickup_time	String	Scheduled time for vehicle pickup (format: H:i).
pickup_date	String	Scheduled date for vehicle pickup (format: YYYY-MM-DD).
title	String	Title of the customer (e.g., Mr, Mrs, Miss).
first_name	String	First name of the customer.
last_name	String	Last name of the customer.
customer_email	String	Email address this is agent email for conformation email.
phone_number	String	Contact phone number of the customer.
departure_flight_number	String	Flight number of the departure flight.
arrival_flight_number	String	Flight number of the return/arrival flight.
departure_terminal	String	Terminal of departure at the airport.
arrival_terminal	String	Terminal of arrival at the airport.
car_registration_number	String	Vehicle registration number.
car_make	String	Make/brand of the car (e.g., Ford, BMW).
car_model	String	Model of the car (e.g., Fiesta, X5).
car_color	String	Color of the car.
park_api	String	Booking source identifier (e.g., b2b, direct).
passenger	String	Number of passengers for the booking.
paymentgateway	String	Payment method used (e.g., Card, Invoice).
payment_token	String	Token received from the payment gateway.
booking_amount	String	Total amount charged for the booking.

                Sample success response  :
                {
                    "status": "success",
                    "message": "Booking created successfully",
                    "reference": "MG-012504221916",
                }
                

RESPONSE PARAMETERS

Field	Type	Description
status	String	Indicates the status of the API response. In this case, 'success' denotes a successful completion of the parking booking.
message	String	Booking created successfully
reference	String	A unique parking reference code for the booking for customer, in this case, "MG-012504221916".

BOOKING AMENDMENT

Non-Flexible Booking: This type of booking cannot be modified once confirmed. Flexible Booking: Modifications to this booking type are permitted, provided they are made at least 24 hours prior to the scheduled departure date. Using Stripe Payment Intent Method, API doesn't support Extend Booking Request.For date change cancel the booking and book again.But if you want to change only the airport details or customer details follow the bellow request

                curl \
                -X POST https://api.magrgroup.com/api/amend/ \
                -H 'Content-Type: application/json' \
                -H 'Cache-Control: no-cache' \
                -d '{
                    "company_code": "HAPS-001",
                    "bookreference": "CDC-012504222077",
                    "amend_booking": "amend_booking",
                    "dropoff_time": "09:00",
                    "dropoff_date": "2025-04-24",
                    "pickup_time": "09:00",
                    "pickup_date": "2025-04-29",
                    "title": "Mr",
                    "first_name": "test",
                    "last_name": "test",
                    "customer_email": "b2b@meetandgreetparkingdeals.com",
                    "phone_number": "23433323",
                    "departure_flight_number": "TBA",
                    "arrival_flight_number": "test",
                    "departure_terminal": "Terminal 2",
                    "arrival_terminal": "Terminal 3",
                    "car_registration_number": "test",
                    "car_make": "test",
                    "car_model": "test",
                    "car_color": "test",
                    "park_api": "b2b",
                    "passenger": 1,
                    "paymentgateway": "Invoice",
                    "payment_token": "pi_3RGghGL3PGdUbgCn0UtqdIj3",
                    "booking_amount": 50.99,
                    "agent_code": "Ic5w0rP2kWu4M5DVDUztZH6tYqPb",
                    "user_email": "b2b@meetandgreetparkingdeals.com",
                    "password": "1234"
                }'
                

Field	Type	Description
agent_code	String	Your secret agent code used for authentication.
user_email	String	User Email of the booking partner or agent.
password	String	Password of the booking partner or agent.
company_code	String	Unique code assigned to the parking company.
bookreference	String	the Unique booking reference that will get in response of booking conformation.
amend_booking	String	Flag to indicate if this is an amendment to an existing booking.
dropoff_time	String	Scheduled time for vehicle its change able in amend drop-off (format: H:i).
dropoff_date	String	Scheduled date for vehicle that will be at booking time its not change drop-off (format: YYYY-MM-DD).
pickup_time	String	Scheduled time for vehicle its change able in amend pickup (format: H:i).
pickup_date	String	Scheduled date for vehicle that will be at booking time its not change pickup (format: YYYY-MM-DD).
title	String	Title of the customer (e.g., Mr, Mrs, Miss).
first_name	String	First name of the customer.
last_name	String	Last name of the customer.
customer_email	String	Email address this is agent email for conformation email.
phone_number	String	Contact phone number of the customer.
departure_flight_number	String	Flight number of the departure flight.
arrival_flight_number	String	Flight number of the return/arrival flight.
departure_terminal	String	Terminal of departure at the airport.
arrival_terminal	String	Terminal of arrival at the airport.
car_registration_number	String	Vehicle registration number.
car_make	String	Make/brand of the car (e.g., Ford, BMW).
car_model	String	Model of the car (e.g., Fiesta, X5).
car_color	String	Color of the car.
park_api	String	Booking source identifier (e.g., b2b, direct).
passenger	String	Number of passengers for the booking.
paymentgateway	String	Payment method used (e.g., Card, Invoice) at booking time.
payment_token	String	Token received from the payment gateway at booking time .
booking_amount	String	Total amount charged for the booking.

RESPONSE PARAMETERS

        Amend Sample Success response :
        {
            "status": "success",
            "message": "Booking updated successfully",
            "reference": "MG-012504221916",
        }
        

        Amend Sample user email,key or password Error response :
        {
            "status": "Error",
            "message": "Invalid API Credentials (User not found)",
            }
        

        Amend Sample 48 Hours Error response :
        {
            "status": "Error",
            "message": "Booking cannot be amended within 48 hours of departure",
            
        }
        

        Amend Sample NonFlex Error response :
        {
            "status": "Error",
            "message": "the product must be flex",
                
        }
        

Field	Type	Description
Status	String	Indicates the status of the API response. 'success' denotes a successful completion of the booking amendment. 'error' denotes failure of booking amendment..
message	String	if 'success' a confirmation message to show that booking has been amended successfully. if 'error' a response message to show the reason why booking cannot be amended.
reference	String	A unique parking reference code that send in request for update, in this case, "MG-012504221916".

BOOKING CANCELLATION

The JSON object outlined below represents the request payload structure for initiating a booking cancellation request via the API. This section will detail each field within the object to provide a clear understanding of the data required for a successful API request, need to make a POST call to the following Endpoint : /cancel

                curl \
                -X POST https://api.magrgroup.com/api/cancel/ \
                -H 'Content-Type: application/json' \
                -H 'Cache-Control: no-cache' \
                -d '{ 
                    "booking_ref": "CDC-012504222077",
                    "refund": 50.99,
                    "agent_code": "Ic5w0rP2kWu4M5DVDUztZH6tYqPb",
                    "user_email": "b2b@meetandgreetparkingdeals.com",
                    "password": "1234"
                }'
                

Field	Type	Description
agent_code	String	Your secret agent code used for authentication.
user_email	String	User Email of the booking partner or agent.
password	String	Password of the booking partner or agent.
booking_ref	String	the Unique booking reference that will get in response of booking conformation.
refund	String	Total amount refund for the booking.whcih is not more then the acutal booking amount

RESPONSE PARAMETERS

                Cancellation Sample response :
        {
            "status": "success",
            "message": "Booking Cancelled successfully",
            "booking_ref": "MG-012504221916",
        }
        

        Cancel Sample user email,key or password Error response :
        {
            "status": "Error",
            "message": "Invalid API Credentials (User not found)",
            }
        

        Cancel Sample 48 Hours Error response :
        {
            "status": "Error",
            "message": "Booking cannot be Cancel within 48 hours of departure",
            
        }
        

        Cancel Sample NonFlex Error response :
        {
            "status": "Error",
            "message": "the product must be flex",
                
        }
        

Field	Type	Description
Status	String	Indicates the status of the API response. 'success' denotes a successful completion of the booking Cancellatoin. 'error' denotes failure of booking Cancellatoin..
message	String	if 'success' a confirmation message to show that booking has been Cancellatoin successfully. if 'error' a response message to show the reason why booking cannot be Cancellatoin.
reference	String	A unique parking reference code that send in request for update, in this case, "MG-012504221916".

Errors Response

The meet and greet API sent following error response:

EMPTY OR INVALID LOGIN EMAIL & HASH KEY PARAMETERS

                Error Sample response :
        {
            "status": "Error",
            "message": "User Email is required or Invalid API Credentials ",
            
        }
        

        Error Sample response :
        {
            "status": "Error",
            "message": "Your request is for live API but your account is in test mode ",
            
        }
        

        Error Sample response :
        {
            "status": "Error",
            "message": "e.g Booking Reference is Missing. Payment Transaction is Missing.",
            
        }
        

Field	Type	Description
Status	String	Indicates the status of the API response. In this case, 'error' denotes a failure to provide wrong / empty required parameters.
message	String	User Email is required or Invalid API Credentials

TEST / LIVE API MODE

Field	Type	Description
Status	String	Indicates the status of the API response. In this case, 'error' denotes a failure using Live / Test API over wrong end points.
message	String	Your request is for live API but your account is in test mode

TEST / LIVE API MODE

Field	Type	Description
Status	String	Indicates the status of the API response. In this case, 'error' denotes a failure when sending wrong , invalid or empty required parameters.
message	String	Contains detail of missing parameters.