Taxi Booking, Automated Dispatch System, Driver, Clients Apps | API Integration

API Integration

PRODUCT TYPE

Get our free white label mobile application and open API which will enable you to customize it and easily transform the application, not forcing you to stick with a standard user interface.

The Open API service, will allow any partner or affiliate to integrate a range of different Smart2Car services, without customers having to leave their website or application.

Our business is continuing to grow globally with new companies in almost every continent, so we’re excited to be opening up our service and making this available through the applications and websites customers are already using, in addition to our own.

We have one of the most flexible and advanced API, enabling you to connect to any software, offering you endless possibilities.

Developers can integrate our APIs into 3rd party applications to request information on available car types, driver location expressed in geo-coordinates, time estimates, estimated prices (including currency conversion when applicable), as well as user account history and activity.

We are completely API enabled and are able to integrate with other dispatch systems, booking applications, Web-Bookers and anything that can send and receive HTTP requests.

Bellow, some examples of the API we are using:

Booking

RESOURCE

POST /v1/operator/booking

RESPONSE

Status-Code: 200 OK

{
  “BookingList”: [
  {
    “Booking”: {
            “id_car_type”:“147”,
            “id_client”:“33”,
            “id_driver_to_car”:null,
            “passenger_name”:“Demo Insoftdev”,
            “passenger_email”:“demo@insoftd.com”,
            “passenger_mobile”:“50001464”,
            “payment_method”:“cash”,
            “status”:“Unallocated”,
            “source”:“backoffice”,
            “infant_seats_number”:0,
            “child_seats_number”:0,
            “booster_seats_number”:0,
            “passengers_number”:“4”,
            “pickup_address”:“London N22 7AY, United Kingdom”,
            “dropoff_address”:“SW11, United Kingdom”,
            “pickup_time”:“2015-8-19 1:1:0”,
            “pickup_lat”:51.59402979999999,
            “pickup_lng”:-0.129408900000044,
            “dropoff_lat”:51.4677636,
            “dropoff_lng”:-0.17013059999999314,
            “duration”:5410,
            “journey_distance”:63127,
            “waiting_time”:0,
            “journey_type”:“later”,
            “booking_type”:1,
            “pickup_details”:“”,
            “dropoff_details”:“”
    },
    “BookingCharge”:{
            “extra_card_payment”:0,
            “base_journey_charge”:59,
            “driver_base_journey_charge”:0,
            “extra_baby_seat”:0,
            “extra_stow”:0,
            “duration_charge”:0,
            “extra_waiting_time”:0,
            “extra_car_type”:1,
            “exception”:0,
            “cash”:60,
            “credit”:0,
            “commission”:0,
            “discount”:0,
            “driver_tip”:0,
            “total_journey”:60,
            “driver_total_journey”:0,
            “zone_extra_charge”:0,
            “voucher_discount”:0,
            “administration_fee”:0,
            “vat”:0,
            “driver_charges_1”:0,
            “driver_charges_2”:0,
            “driver_earnings”:0,
            “company_earnings”:0,
            “pay_to_driver”:0,
            “pay_to_company”:0,
            “company_report_income”:0,
            “company_report_income_vat”:0,
            “company_report_vat”:0,
            “percent_driver_total”:0
    },
    “JourneyWaypoint”:[
    {
            “lat”:51.4795379,
            “lng”:-0.45301919999997153,
            “address”:“Longford, Greater London, UK”,
            “type”:“w”,
            “dragId”:1
    }
    ],
    “Payment”:{
            “payment_status”:“Pending”
    }
  }
  ]
}

Booking by ID

RESOURCE

GET v1/operator/booking/complex/id_booking

RESPONSE

Status-Code: 200 OK

{
  “Booking”: [
  {
            “id_booking”:“38400”,
            “id_company”:“20”,
            “id_recurring_booking”:null,
            “id_booking_charge”:“39233”,
            “airline_name”:null,
            “booking_type”:“1”,
            “payment_method”:“cash”,
            “booster_seats_number”:“0”,
            “checkin_luggage”:null,
            “child_seats_number”:“0”,
            “client_alternative_mobile”:null,
            “client_email”:null,
            “client_mobile”:null,
            “client_name”:null,
            “dropoff_address”:“SW11, United Kingdom”,
            “created_at”:“2015-08-06 09:16:40”,
            “departure_city”:null,
            “display_name”:null,
            “dropoff_address”:“Heathrow Airport, Longford, United Kingdom”,
            “dropoff_details”:“”,
            “dropoff_lat”:“51.4795379”,
            “dropoff_lng”:“-0.45301919999997”,
            “dropoff_time”:null,
            “duration”:“1599”,
            “flight_type”:null,
            “hand_luggage”:null,
            “id_booking”:“38400”
            “id_booking_charge”:“39233”,
            “id_car_type”:“147”,
            “id_client”:“33”,
            “id_company”:“20”,
            “id_driver_to_car”:“42”,
            “id_payment”:“39105”,
            “id_recurring_booking”:null,
            “id_ref”:null,
            “id_web_booker”:null
            “infant_seats_number”:“0”,
            “journey_distance”:“23045.00”,
            “journey_type”:“later”,
            “landing_flight_number”:null,
            “observations”:null,
            “op_observations”:null,
            “passenger_alternative_mobile”:null,
            “passenger_email”:“demo@insoftd.com”,
            “passenger_mobile”:“02031500250”,
            “passenger_name”:“Demo Insoftdev”,
            “passengers_number”:“4”,
            “payment_method”:“cash”,
            “pickup_address”:“Natural History Museum, Cromwell Road, London, United Kingdom”,
            “pickup_details”:“there is a yellow house”,
            “pickup_duration_delay”:null,
            “pickup_lat”:“51.4954844”,
            “pickup_lng”:“-0.1763244”,
            “pickup_time”:“2015-08-13 03:03:00”,
            “send_to_driver_account”:“0”,
            “source”:“backoffice”,
            “status”:“Allocated”,
            “updated_at”:“2015-08-06 09:16:59”,
            “waiting_time”:“0”
  }
  ]
  “BookingCharge”: [
  {
            “id_booking_charge”:“39233”,
            “extra_card_payment”:“0.00”,
            “base_journey_charge”:“22.00”,
            “administration_fee”:“0.00”,
            “base_journey_charge”:“22.00”,
            “cash”:“20.00”,
            “commission”:“-3.00”,
            “company_earnings”:“0.00”,
            “company_report_income”:“0.00”,
            “company_report_income_vat”:“0.00”,
            “company_report_vat”:“0.00”,
            “credit”:“0.00”,
            “discount”:“0.00”,
            “driver_base_journey_charge”:“0.00”,
            “driver_charges_1”:“0.00”,
            “driver_charges_2”:“0.00”,
            “driver_earnings”:“0.00”,
            “driver_tip”:“0.00”,
            “driver_total_journey”:“0.00”,
            “duration_charge”:“0.00”,
            “exception”:“0.00”,
            “extra_baby_seat”:“0.00”,
            “extra_car_type”:“1.00”,
            “extra_card_payment”:“0.00”,
            “extra_stow”:“0.00”,
            “extra_waiting_time”:“0.00”,
            “id_booking_charge”:“39233”
            “pay_to_company”:“0.00”,
            “pay_to_driver”:“0.00”,
            “percent_driver_total”:“0.00”,
            “total_journey”:“20.00”,
            “vat”:“0.00”,
            “voucher_discount”:“0.00”,
            “zone_extra_charge”:“0.00”
  }
  ]
  “Car”: [
  {
            “id_car”:“27”,
            “id_company”:“20”,
            “id_type”:“147”,
            “model”:“test”,
            “color”:“red”,
            “reg_number”:“123”,
            “co2”:null,
            “mot_expire”:“2020-02-11”,
            “phv_expire”:“2020-02-11”,
            “phv_licence_number”:“123”,
            “picture”:null,
            “record_status”:“N”,
            “reg_number”:“123”,
            “tax_road_expire”:null,
            “driver_charges_1”:“0.00”
  }
  ]
  “Client”: [
  {
            “id”:“33”,
            “id_company”:“20”,
            “id_user_type”:“6”,
            “id_account”:null,
            “registered”:“manual”,
            “title”:“Mr”,
            “account_source”:“backoffice”,
            “alternative_mobile”:“02031500250”,
            “city”:“London”,
            “created_at”:“2015-01-01 00:00:00”,
            “display_name_on_board”:“0”,
            “email”:“demo@insoftd.com”,
            “last_login”:null,
            “miles_used”:“0”,
            “mobile_number”:“02031500250”
            “name”:“Demo Insoftdev”,
            “news_subscribed”:null,
            “observations”:null,
            “online”:“0”,
            “password”:“79a59e28d48da45e304778e27c07fa8da0a9c7c0”,
            “postcode”:“”,
            “registered”:“manual”,
            “residence_number”:“”,
            “street”:“”,
            “title”:“Mr”,
            “total_miles”:“0”,
            “updated_at”:“2015-07-27 16:29:16”,
            “vat_charged”:“0”,
            “visit_number”:“0”
  }
  ]
  “Driver”: [
  {
            “id”:“45”,
            “id_company”:“20”,
            “id_user_type”:“5”,
            “first_name”:“Demo”,
            “last_name”:“Insoftdev”,
            “car_insurance”:“2020-02-11”,
            “contract_type”:“full_time”,
            “date_of_birth”:“1980-02-11”,
            “dbs_check”:“2017-07-01”,
            “driver_licence_expire”:“2020-01-01 00:00:00”,
            “driver_licence_numbe”:“123”,
            “email”:“demo@insoftd.com”,
            “first_name”:Demo,
            “full_address”:“address”,
            “mobile_number”:“02031500250”
            “nationality”:“british”,
            “ni_number”:“123”,
            “password”:“70e91a0d058fa7a853b2c9d308e242633ac4f207”,
            “pco_expire”:“2020-02-11”,
            “pco_licence_number”:“123”,
            “picture”:“uploads/company_20/images/drivers/id_driver_45.jpg”,
            “postcode”:“postcode”,
            “status”:“1”,
            “tag”:“Driver 01”
  }
  ]
  “Payment”: [
  {
            “id_payment”:“39105”,
            “order_id”:null,
            “payment_status”:“Pending”,
            “created_at”:“2015-08-06 09:16:40”,
            “updated_at”:“2015-08-06 09:16:59”
  }
  ]
}

Add Car Type

RESOURCE

POST /v1/operator/car_type

RESPONSE

Status-Code: 200 OK

{
  “CarType”:{
            “type”:“test”,
            “car_list”:“test”,
            “seats_number”:3,
            “hand_luggage”:3,
            “checkin_luggage”:3
  }
}

Add Car

RESOURCE

POST /v1/operator/car

RESPONSE

Status-Code: 200 OK

Driver List

RESOURCE

GET v1/operator/driver/list

RESPONSE

Status-Code: 200 OK

ADD Client

RESOURCE

POST v1/operator/client

RESPONSE

Status-Code: 200 OK

{
  “Client”:{
            “isNew”:“true”,
            “id_user_type”:“6”,
            “id_discount_rule”:null,
            “vat_charged”:1,
            “registered”:manual,
            “account_source”:“backoffice”,
            “name”:“Test”,
            “email”:test@isd.com,
            “mobile_number”:02031500250,
            “city”:London
            “street”:“105 Mayes Road”,
            “postcode”:N22 6UP,
            “residence_number”:105,
            “id_account”:6
            “title”:Mr,
            “password”:passenger2015
  }
}

Price

RESOURCE

POST /v1/operator/price

RESPONSE

Status-Code: 200 OK

{
  “priceList”: [
  {
    “BookingCharge”: {
            “cash”:“0”,
            “credit”:“0”,
            “driver_tip”:0,
            “override_price”:“0”,
            “old_payment_method”:“cash”,
    “RouteInfo”:{
            “legs”:97110,
            “duration”:4594,
            “distance”:97110,
    “points_list”:[
    {
            “lat”:51.5946194,
            “lng”:-0.1115675,
            “address”:“N22 6SY, UK”,
            “type”:“p”,
    },
    {
            “lat”:51.1568094,
            “lng”:-0.1540062,
            “address”:“RH6 0NP, UK”,
            “type”:“d”,
  }
  ]
  “Booking”: {
            “id_car_type”:“147”,
            “infant_seats_number”:“0”,
            “child_seats_number”:0,
            “booster_seats_number”:0,
            “id_client”:null,
            “pickup_time”:“null”,
            “passengers_number”:“4”,
            “payment_method”:“cash”,
            “waiting_time”:0,
  }
  ]
}