Theme switcher

Book a ride

Header Parameters

Authorizationstring Required

Bearer token auth which can be used instead of sending the b2bpartner_id and key in payload

Body Parameters

partnerstring Required

(Deprecated) Partner name as provided by hoppa contact. This field is deprecated — use b2bpartner_id instead.

b2bpartner_idstring Required

b2bpartner_id provided by hoppa. Use this field instead of the deprecated partner field.

keystring Required

This key is provided by your Hoppa contact. Note that separate keys are issued for the sandbox and production environments. Be sure to use the appropriate key depending on the environment you are working in.

quote_idstring

"quote_id" provided from the quote response. Please refer to the "Ride Quotes" documentation. This is only for ride booking for road transportation

referencestring Required

A reference number or code for the ride booking. This reference is how the partner identifies the ride booking in their system

priceobject Required

The total price or cost of the ride.

child_seat_countnumber

Number of child seats required

infant_seat_countnumber

Number of infant seats required

toddler_seat_countnumber

Number of toddler seats required

fromobject Required

The starting location or point of origin for the ride.

toobject Required

The destination location or endpoint of the ride.

vehicle_classstring Required

The class or type of vehicle for the ride.

passengerobject

This is the lead passenger object

co_passengersarray
timenumber Required

"time" is the pickup date and time of ride. "time" is specified in epoch time, or unix time, which is the number of seconds that have elapsed since 00:00:00 UTC on 1 January 1970. For more information on epoch time refer to: https://www.epochconverter.com/

return_timenumber

"return_time" is the return date and time of ride. "return_time" is specified in epoch time, or unix time, which is the number of seconds that have elapsed since 00:00:00 UTC on 1 January 1970. For more information on epoch time refer to: https://www.epochconverter.com/

durationnumber

Duration of the ride.

meet_and_greetstring

Whether a meet-and-greet service is requested for the ride.

Default value
No
Enum values:
yes
Request Meet and Greet
no
No Meet and Greet
Empty value:
True
arrival_flightobject

Arrival flight information

departure_flightobject

Departure flight information

ride_typestring

This is to identify a ride as a round trip if there are 2 trips, if not defined it will appear as a charter ride

tripsarray

The trips array represents the legs of a multi-day journey. Each object in the array corresponds to a single trip. If trips is not provided, the ride is treated as a standard one-way, round trip or hourly booking. if any of the parameter are missing at the trip level , it takes the parameter from the root level.

Response

200
Object

Success

Response Attributes

ride_idnumber

Unique Reference for the ride from hoppa

priceobject
400
Object

Empty body request

Response Attributes

errCodenumber
errMsgstring
403
Object

No key in body

Response Attributes

errCodenumber
errMsgstring
500
Object

System error

Response Attributes

errCodenumber
errMsgstring

Train request

request_idstring

unique request id

partnerstring

partner name as provided by hoppa contact

keystring

This key is provided by your Hoppa contact. Note that separate keys are issued for the sandbox and production environments. Be sure to use the appropriate key depending on the environment you are working in.

quote_idstring

quote identifier for the quotes api

referencestring

unique reference for the ride

tripsarray

The trips array, one trip object for each journey

passengerobject
co_passengersarray

One Way (Request)

partnerstring
keystring
referencestring
quote_idstring
fromobject
toobject
timenumber
priceobject
vehicle_classstring
passengerobject
meet_and_greetboolean
arrival_flightobject

Round Trip (Request)

partnerstring
keystring
referencestring
quote_idstring
fromobject
toobject
timenumber
return_timenumber
priceobject
vehicle_classstring
passengerobject
arrival_flightobject
departure_flightobject

Hourly Ride (request)

partnerstring
keystring
referencestring
quote_idstring
fromobject
toobject
durationnumber
timenumber
priceobject
vehicle_classstring
passengerobject

Multiday Ride (Request)

partnerstring
keystring
referencestring
quote_idstring
toddler_seat_countnumber
child_seat_countnumber
infant_seat_countnumber
vehicle_countnumber
passengerobject
priceobject
tripsarray
meet_and_greetboolean

Ride hailing

partnerstring
keystring
referencestring
quote_idstring
timenumber
fromobject
toobject
priceobject
vehicle_classstring
passengerobject
Was this section helpful?

Base URL

Production:

Sandbox:

Language Box

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 { "request_id": "unique-request-id", "partner": "partner-name-as-provided-by-hoppa", "key": "api-key-as-provided-by-hoppa", "quote_id": "quote-id-from-ride-quotes-api", "reference": "UNIQUE-REFERENCE", "trips": [ { "quote_id": "quote-id-from-ride-quotes-api", "trip_no": 1 }, { "quote_id": "quote-id-from-ride-quotes-api", "trip_no": 2 } ], "passenger": { "first_name": "Emily Ashwills", "last_name": "Calero", "email": "test@test.com", "cell_phones": [ "+501234567890" ], "government_id_type": "passport", "government_id": "123456787", "age": 25 }, "co_passengers": [ { "first_name": "Rebeca Emilia Sandoval", "last_name": "Calero", "age": 23, "email": "test@test.com", "salutation": "Mr", "cell_phones": [ "+501234567890" ], "government_id_type": "passport", "government_id": "123456789" } ] }

POST

/

Select
1

Response

Was this section helpful?