📦 Search V2 - Objects Response Format

Objects Format

Here are the formats used by our API:

Links

Name	Type	Comment
_self	string	API link to the resource
_front	string	Front web URL link to the resource

Pager

Name	Type	Comment
page	int	Number of the current page
pages	int	Total number of pages
total	int	Total number of results
limit	int	Current number of results per page

Trip

Name	Type	Comment
links	Object	Links to the corresponding trip
departure_date	string	Locale Date of departure of the trip (format: JJ/MM/YYYY HH:MM:SS) example: 05/09/2019 11:20:00
departure_date_iso8601	string	Date of departure of the trip (format: iso8601) example: 2019-09-05T11:20:00+01:00
is_passed	bool	Has the trip already started
departure_place	Place Object	Place of departure of the trip
arrival_place	Place Object	Place of arrival of the trip
departure_meeting_point	Place Object	Related Meeting point for the departure
price	Price Object	Price of 1 seat
price_with_commission	Price Object	Full Price including the commission
price_without_commission	Price Object	Net Price asked by the driver
commission	Price Object	Value of the commission
seats_left	int	Number of available seats
seats	int	Number of seats on the trip
seats_count_origin	int	Initial number of seats on the trip
duration	Value Object	Value and unity of the trip duration
distance	Value Object	Value and unity of the trip distance
permanent_id	string	Permanent identifier of the trip
main_permanent_id	string	Identifier of the main trip, if this one is a subtrip
comment	string	Comment of trip as published by the driver
car	Car Object	Associated car the trip
viaggio_rosa	bool	Is this a women only trip?
is_comfort	bool	Is this a "max 2 in the back seats" trip?
freeway	bool	Will the trip use an highway?
stop_overs	Array of Places	Array of stopovers for the trip
bucketing_eligible	bool	Eligible to bucketing?
booking_mode	string	The booking approval mode, one of "auto", "manual"
booking_type	string	The payment type, one of "online", "onboard"
is_booking_allowed	Object	Is it possible to book on this trip?
view_count	int	Number of display of this trip
cross_border_alert	true	Is this trip crossing a border?
trip_plan	Array of Places	Itinerary planned for the trip
messaging_status	string	"public" or "private"
passengers	Array of Passengers	Passengers already booked on the same trip
display_contact	bool	Is it possible to contact the driver?
vehicle_pictures	Array of
can_report	bool	Is it possible to report the driver?

The format of each response object is detailed here.

Click here to see a Json example

Here is a JSON example:

Hide

{
  "links": {
    "_self": "https://api.blablacar.com/api/v2/trips/1688387811-paris-london", 
    "_front": "https://www.blablacar.co.uk/trip/carpooling/1688387811-paris-london/"
  }, 
  "departure_date": "05/09/2019 11:20:00", 
  "departure_date_iso8601": "2019-09-05T11:20:00+01:00", 
  "is_passed": false, 
  "departure_place": {
    "city_name": "Paris", 
    "address": "Métro Nation, Paris", 
    "latitude": 48.847611, 
    "longitude": 2.3955668, 
    "country_code": "FR", 
    "meeting_point_id": 462828
  }, 
  "arrival_place": {
    "city_name": "London", 
    "address": "Victoria Station", 
    "latitude": 51.49521, 
    "longitude": -0.143897, 
    "country_code": "GB"
  }, 
  "departure_meeting_point": {
    "id": 462828, 
    "name": "Métro Nation", 
    "full_name": "Métro Nation, Paris", 
    "city_name": "Paris", 
    "address": "23 Rue Fabre d'Eglantine, 75012 Paris, France", 
    "latitude": 48.847611, 
    "longitude": 2.3955668, 
    "country_code": "FR", 
    "tags": [
      "train_station"
    ]
  }, 
  "price": {
    "value": 36.5, 
    "currency": "GBP", 
    "symbol": "£", 
    "string_value": "£36.50", 
    "price_color": "BLACK"
  }, 
  "price_with_commission": {
    "value": 36.5, 
    "currency": "GBP", 
    "symbol": "£", 
    "string_value": "£36.50", 
    "price_color": "BLACK"
  }, 
  "price_without_commission": {
    "value": 30, 
    "currency": "GBP", 
    "symbol": "£", 
    "string_value": "£30.00", 
    "price_color": "BLACK"
  }, 
  "commission": {
    "value": 6.5, 
    "currency": "GBP", 
    "symbol": "£", 
    "string_value": "£6.50"
  }, 
  "seats_left": 3, 
  "seats": 3, 
  "seats_count_origin": 3, 
  "duration": {
    "value": 22800, 
    "unity": "s"
  }, 
  "distance": {
    "value": 458, 
    "unity": "km"
  }, 
  "permanent_id": "1688387811-paris-london", 
  "main_permanent_id": "1688387811-orleans-london", 
  "comment": "Hello . I am going back to London and using eurotunnel. Please come on time  thanks and safely journee . First I am living orlean gare centre at 9:40 for porte de la chapelle. 11:30 departure from porte de la chapelle for London, Victoria", 
  "car": {
    "id": "sQkfQPJXESDDvOAIOYFVXQ", 
    "model": "PRIUS", 
    "make": "TOYOTA", 
    "color": "White", 
    "color_hexa": "FFFFFF", 
    "comfort": "Normal", 
    "comfort_nb_star": 2, 
    "number_of_seat": 4, 
    "category": "_UE_BERLINE", 
    "picture": "https://cdn.blablacar.com/comuto3/images/rebranding/icons/vehicles/car-saloon.svg"
  }, 
  "viaggio_rosa": false, 
  "is_comfort": true, 
  "freeway": true, 
  "stop_overs": [
    {
      "city_name": "Orléans", 
      "address": "Hôtel Campanile Orléans Centre Gare", 
      "latitude": 47.90613, 
      "longitude": 1.905251, 
      "country_code": "FR"
    }, 
    {
      "city_name": "Paris", 
      "latitude": 48.847611, 
      "longitude": 2.3955668, 
      "country_code": "FR", 
      "departure_place": true
    }, 
    {
      "city_name": "London", 
      "address": "Victoria Station", 
      "latitude": 51.49521, 
      "longitude": -0.143897, 
      "country_code": "GB", 
      "arrival_place": true
    }
  ], 
  "bucketing_eligible": false, 
  "booking_mode": "manual", 
  "booking_type": "online", 
  "is_booking_allowed": true, 
  "view_count": 22, 
  "cross_border_alert": true, 
  "trip_plan": [
    {
      "date": "05/09/2019 09:40:00", 
      "city": "Orléans", 
      "address": "Hôtel Campanile Orléans Centre Gare", 
      "latitude": 47.90613, 
      "longitude": 1.905251, 
      "country_code": "FR", 
      "meeting_point_id": 0, 
      "vinci_shuttle_enabled": false
    }, 
    {
      "date": "05/09/2019 11:20:00", 
      "city": "Paris", 
      "address": "Métro Nation, Paris", 
      "latitude": 48.847611, 
      "longitude": 2.3955668, 
      "country_code": "FR", 
      "meeting_point_id": 462828, 
      "vinci_shuttle_enabled": false
    }, 
    {
      "date": "05/09/2019 17:40:00", 
      "city": "London", 
      "address": "Victoria Station", 
      "latitude": 51.49521, 
      "longitude": -0.143897, 
      "country_code": "GB", 
      "meeting_point_id": 0, 
      "vinci_shuttle_enabled": false
    }
  ], 
  "messaging_status": "private", 
  "passengers": [], 
  "display_contact": true, 
  "vehicle_pictures": [], 
  "can_report": false
}

Facet

Name	Type	Comment
name	string	Name of this property. May be "seats", "date", "hour", "price", "photo", "experience" or "car_comfort"
type	string	Type of this value, may be "checkbox", "radio" or "custom"
items	Array of facet item

Facet item

Name	Type	Comment
value	int	Value of the facet
count	int	Count of elements which match the value
is_selected	bool	Is this element part of the current response?

Place

Name	Type	Comment
city_name	string	City Name of the place
address	string	Address of the place
latitude	float	Latitude coordinate
longitude	float	Longitude coordinate

Price

Name	Type	Comment
value	int	Amount of the price
currency	string	Currency
symbol	string	Symbol of the currency
string_value	string	Formated value, as it should be displayed
price_color	string	One of "GREEN", "ORANGE", "RED", "BLACK"

Value

Name	Type	Comment
value	int	Amount of the value
unity	string	Unity of the value

Name	Type	Comment
model	string	Model of the car
make	string	Maker of the car
comfort	string	Possible values: "Luxury", "Comfortable", "Normal"
comfort_nb_star	int	Integer value of the comfort
category	string	Category of the car