Theme switcher

Book a ride

Body Parameters

partnerstring Required

partner name as provided by Hoppa contact

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.

Show child attributes

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.

Show child attributes

toobject Required

The destination location or endpoint of the ride.

Show child attributes

vehicle_classstring Required

The class or type of vehicle for the ride.

passengerobject

This is the lead passenger object

Show child attributes

co_passengersarray

Show child attributes

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

Show child attributes

departure_flightobject

Departure flight information

Show child attributes

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.

Show child attributes

Response

200
Object

Success

Response Attributes

ride_idnumber

Unique Reference for the ride from hoppa

priceobject

Show child attributes

400
Object

Empty body request

Response Attributes

errCodenumber
errMsgstring
400
Object

Ride already created with same payload

Response Attributes

errCodenumber
errMsgstring
400
Object

Person count mismatch

Response Attributes

errCodenumber
errMsgstring
400
Object

Person count could not be processed

Response Attributes

errCodenumber
errMsgstring
400
Object

incorrect "from place" or "to place"

Response Attributes

errCodenumber
errMsgstring
400
Object

Time is in the past

Response Attributes

errCodenumber
errMsgstring
400
Object

Return time is in the past

Response Attributes

errCodenumber
errMsgstring
400
Object

Return time is before start time

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

Show child attributes

passengerobject

Show child attributes

co_passengersarray

Show child attributes

One Way (Request)

partnerstring
keystring
referencestring
quote_idstring
fromobject

Show child attributes

toobject

Show child attributes

timenumber
priceobject

Show child attributes

vehicle_classstring
passengerobject

Show child attributes

meet_and_greetboolean
arrival_flightobject

Show child attributes

Round Trip (Request)

partnerstring
keystring
referencestring
quote_idstring
fromobject

Show child attributes

toobject

Show child attributes

timenumber
return_timenumber
priceobject

Show child attributes

vehicle_classstring
passengerobject

Show child attributes

arrival_flightobject

Show child attributes

departure_flightobject

Show child attributes

Hourly Ride (request)

partnerstring
keystring
referencestring
quote_idstring
fromobject

Show child attributes

toobject

Show child attributes

durationnumber
timenumber
priceobject

Show child attributes

vehicle_classstring
passengerobject

Show child attributes

Multiday Ride (Request)

partnerstring
keystring
referencestring
quote_idstring
toddler_seat_countnumber
child_seat_countnumber
infant_seat_countnumber
vehicle_countnumber
passengerobject

Show child attributes

priceobject

Show child attributes

tripsarray

Show child attributes

meet_and_greetboolean

Ride hailing

partnerstring
keystring
referencestring
quote_idstring
timenumber
fromobject

Show child attributes

toobject

Show child attributes

priceobject

Show child attributes

vehicle_classstring
passengerobject

Show child attributes

Was this section helpful?
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?
View as Markdown

Ask an AI

Open in ChatGPTOpen in ClaudeOpen in Perplexity

Code with AI

Open in Copilot