Single Passenger ride
Duplications
to prevent booking duplicates you can send X-Request-ID ( value: string) in the header
Request
Request URL
--request POST 'https://business-api.gett.com/v1/orders?businessId={businessid}
Name | Type | Description |
---|---|---|
businessId | UUID | Account identifier obtained from Gett while generating credentials |
category | string | Transportation for a ride Delivery to send a package |
product_ID | string | UUID corresponds to available product in the pickup. Obtained from Get Products request. |
scheduled_at | string | The schedule time in format ISO8601: yyyy-mm-ddThh:mm:ss+Z (example: 2017-12-05T18:59:23+03:00). If the parameter is not passed it will default to on-demand |
quote_id | string | Unique id for pre-requested price estimation. Obtained from Price estimation request |
stops | array | The object containing the information about the stops/waypoints, for the ride. |
stops[x].type | string | Represents the type of the stops: origin on_going destination |
stops[x].actions | array | The object contains the passengers info and the relationship for the specific stops e.g. pickup/drop-off in stops |
stops[x].actions.type | string | Represents the type of the action to be performed by the driver: pick_up stop_by drop_off |
stops[x].actions.user | object | A JSON dictionary containing the the passenger name and phone number |
stops[x].actions.user. name | string | Passenger name |
stops[x].actions.user. phone | string | The phone number of the rider. NOTE:phone numbers must be passed in the international format (without "+" sign) as specified in RFC3966. |
stops[x].location | object | A JSON dictionary containing the the location details |
stops[x].location.lat | float | Location latitude |
stops[x].location.lng | float | Location longitude |
stops[x].location.full_address (optional) | string | Address display name |
stops[x].location.address (optional) | object | A JSON dictionary containing the the address details |
stops[x].location.address.address_place (optional) | object | Address provider details |
stops[x].location.address.id(optional) | string | Addresses id from provider e.g google provider id |
stops[x].location.address.provider (optional) | string | Provider name, Gett supports different address providers e.g GOOGLE, POSTCODE, and HERE |
stops[x].location.address.city (optional) | string | City name for stop point address |
stops[x].location.address.country (optional) | string | Country name for stop point address |
stops[x].location.address.full_address (optional) | string | Address in one string for stop point |
stops[x].location.address.house (optional) | string | House number for stop point address |
stops[x].location.address.notes (optional) | string | Notes for stop point |
stops[x].location.address.postcode (optional) | string | Postal code for stop point address |
stops[x].location.address.state (optional) | string | State for stop point address |
stops[x].location.address.street (optional) | string | Street name for stop point address |
note_to_driver (optional) | string | Message to the driver up to 100 chars |
references (optional) | object | Additional fields for ride - for some clients this object is mandatory. review company settings if your are integrating on behalf of a client, be mindful that the client can add mandatory reference fields at any moment from the web platform and the integration should be able to support it |
reference[x].id (optional) | int | Additional field identificator |
reference[X].value (optional) | string | Additional field value |
flight_details | object | flight details are required for airport pickups, mainly for pre-booked orders |
flight_details.flight_number | string | IATA flight code e.g. "BA164" |
flight_details.flight_tracking | boolean | if TRUE the flight will be tracked and rider scheduled_at will be adjusted automatically Scheduled_at must be after the planned landing time, if an earlier scheduled_at is sent the system will look for that last flight landing before the scheduled_at and will change the date of the booking flight details and ride scheduled time must be valid and aligned |
flight_details.offset_from_flight | int | the time in minutes you have added after flight landing time, if provided the system will keep this time as additional minutes after the new landing time, if the flight landing time was updated/changed. e.g. flight lands at 10:00 the requested scheduled_at is 10:50 the offset value must be set to 50 if flight tracking is set to TRUE if the offset was set but not added to scheduled_at, it won't be added automatically at booking but only in case of landing time change |
please note
Two or more consecutive addresses on the route can't be identical.
Roaming/global rides
To request a global/roaming ride (out of the client's country of origin) providing full address breakdown is mandatory
Single Passenger Ride Request
curl --location --request POST 'https://business-api.gett.com/v1/orders?businessId=<companyUUID>' \
--header 'Authorization: Bearer <access token>' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{
"category": "transportation",
"product_id": "d839bf31-200d-4b5c-b735-3f2101c19a6c",
"scheduled_at": "2023-01-25T20:45:00+00:00",
"quote_id": null,
"stops": [
{
"type": "origin",
"actions": [
{
"type": "pick_up",
"user": {
"name": "Passenger 1",
"phone": "447000000000"
}
}
],
"location": {
"lat": 51.4585709149735,
"lng": -0.4453791457396373,
"address": {
"full_address": "Heathrow Terminal 4, Hounslow TW6 3XA, UK",
"address_place": {
"id": "ChIJJV-0krhzdkgRp4xHVJwUCVQ",
"provider": "GOOGLE"
}
}
}
},
{
"type": "destination",
"actions": [
{
"type": "drop_off",
"user": {
"name": "Passenger 1",
"phone": "447000000000"
}
}
],
"location": {
"lat": 51.52289,
"lng": -0.1136,
"address": {
"full_address": "Gett UK, Elm House 10-16, Elm Street, London WC1X 0BJ",
"address_place":{
"id": "GB|RM|A|55201188",
"provider":"POSTCODE"
}
}
}
}
],
"note_to_driver": "",
"flight_details": {
"flight_number": "BA164",
"flight_tracking": true,
"offset_from_flight": 60
},
"references": [
{
"id": 8946,
"value": "Tech"
},
{
"id": 9557,
"value": "Product"
}
]
}'
Single Passenger Ride Response
{
"id": 1307,
"status": "Pending",
"business_id": "6eaaa6cf-3bdc-4393-a8cf-22b500f58006",
"category": "transportation",
"product_id": "d839bf31-200d-4b5c-b735-3f2101c19a6c",
"scheduled_at": "2023-01-25T20:45:00+00:00",
"quote_id": "",
"stops": [
{
"type": "origin",
"actions": [
{
"type": "pick_up",
"user": {
"name": "Passenger 1",
"phone": "447000000000"
}
}
],
"location": {
"lat": 51.4585709149735,
"lng": -0.4453791457396373,
"address": {
"full_address": "Heathrow Terminal 4, Hounslow TW6 3XA, UK",
"city": "Hounslow",
"house": "",
"state": "England",
"street": "",
"country": "UK",
"postcode": "TW6 3XA",
"address_place": {
"provider": "GOOGLE",
"id": "ChIJJV-0krhzdkgRp4xHVJwUCVQ"
}
}
}
},
{
"type": "destination",
"actions": [
{
"type": "drop_off",
"user": {
"name": "Passenger 1",
"phone": "447000000000"
}
}
],
"location": {
"lat": 51.52289,
"lng": -0.1136,
"address": {
"full_address": "Gett UK, Elm House 10-16, Elm Street, London WC1X 0BJ",
"city": "London",
"house": "",
"state": "Camden",
"street": "Elm Street",
"country": "United Kingdom",
"postcode": "WC1X 0BJ",
"address_place": {
"provider": "POSTCODE",
"id": "GB|RM|A|55201188"
}
}
}
}
],
"payment_type": "account",
"note_to_driver": "",
"references": [
{
"id": 8946,
"title": "",
"value": "Tech"
},
{
"id": 9557,
"title": "",
"value": "Product"
}
],
"flight_details": {
"flight_number": "BA164",
"flight_tracking": true,
"offset_from_flight": 60
},
"requested_at": "2022-12-22T19:16:16+00:00"
}
Updated about 1 year ago