API Objects Reference

Comprehensive documentation of all API objects and their fields

OrderRequestObject

Used for creating new orders

Field	Type	Description
waypoints	Array of WaypointObject	Geodata of pickup, intermediate, and drop-off points like coordinates, addresses, etc. Up to 5 points can be mentioned.
extraOptions	Array of Enum	AIR_CONDITION, NON_SMOKING, SMOKING_ALLOWED, EXTRA_LUGGAGE_SPACE, CHILD_SEAT, DISABLED_PEOPLE, PETS_ALLOWED, BIKE_MOUNT
client	CustomerObject	Customer info like name, UUID, image, etc.
notes	String	Text notes for an order.
unitOfLength	Enum	METER, KILOMETER, MILE
specialCost	Number	Special price for the order
tripDistance	Number	Trip distance in units specified in "unitOfLength" param for price estimation.
tripDuration	Integer	Trip duration in milliseconds for price estimation.
pickupTime	String	Pick up time for arrival according to RFC3339 standard
numberOfSeats	Integer	Number of seats needed
vehicleType	Enum	ECONOMY, CLASSIC, BUSINESS, LUXURY, etc.
tariffType	Enum	PRECISE, HOURLY
paymentMethods	Enum	CASH, TERMINAL, THIRD_PARTY
prepaid	Boolean	If true - the trip was paid before it started (currently not supported)
tariffId	String	Service type UUID
manualAssignDriver	String	Driver Id that is used for manual assign
orderSource	Enum	PASSENGER_APP, DISPATCH_PANEL, DISPATCH_API

WaypointObject

Contains location information for a point in the trip

Field	Type	Description
exactLatLng	LatLngObject	Coordinates of the customer
premise	String	A named location, usually a building or collection of buildings with a common name
houseNumber	String	House number
street	String	Street name
subLocality	String	A first-order civil entity below a locality
locality	String	An incorporated city or town political entity
city	String	City name
district	String	District (a subdivision of city)
province	String	Province name
country	String	Country name
postalCode	String	Postal code
countryCode	String	Two-letter country code ISO 3166-1 alpha-2
poiName	String	A named point of interest
placeLatLng	LatLngObject	Coordinates of the place which are used for further geocoding

LatLngObject

Geographic coordinates

Field	Type	Description
lat	Number	Latitude data
lng	Number	Longitude data

CustomerObject

Customer information

Field	Type	Description
clientId	String	Customer UUID
name	String	Customer name
phone	String	Customer mobile phone number
imageUrl	String	Customer profile image
email	String	Customer email (from Customer app)

OrderResponseObject

Response after creating an order

Field	Type	Description
orderId	String	Order UUID

CompanyObject

Field	Type	Description
id	String	Unique identifier for the company
name	String	Company name
logo	String	Company profile image URL
status	String	Current status of the company
createdAt	String	Company creation timestamp in RFC3339 format
updatedAt	String	Last update timestamp in RFC3339 format

OrderOfferObject

Information about an accepted order

Field	Type	Description
eta	String	Estimated time of arrival according to RFC3339 standard
driver	DriverObject	Driver info like name, UUID, profile image, etc.
car	CarObject	Driver's car info like model, colour, year, etc.
tariff	TariffObject	Service type info like name, UUID, currency, etc.

DriverObject

Driver information

Field	Type	Description
driverId	String	Driver UUID
name	String	Driver name
phone	String	Driver mobile phone number
email	String	Driver email
imageUrl	String	Driver profile image

CarObject

Vehicle information

Field	Type	Description
model	String	Car model
color	String	Car color
year	Integer	Car issue year
imageUrl	String	Car image
plateNumber	String	Car number
numberOfSeats	Integer	Number of seats
vehicleType	Enum	Available vehicle types: ECONOMY, CLASSIC, BUSINESS, LUXURY, RICKSHAW, MOTO, TESLA, BLACK_CAR, BLACK_CAB, SUV, MINIVAN, VAN, BUS, LIMOUSINE, HELICOPTER, SPEED_BOAT, YACHT, TOW_TRUCK, AMBULANCE, PARATRANSIT, DELIVERY_TRUCK, MOTO_XL, COURIER, PEDICAB, TOW_TRUCK_SMALL, TOW_TRUCK_INDUSTRIAL, ELECTRIC_VEHICLE, HANDYMAN, PLUMBER, ELECTRICIAN, LOCKSMITH, DOCTOR, NURSE, MAID, BABYSITTER, LAWYER, INSURANCE_INSPECTOR, CLAIMS_ADJUSTER
options	Array of Enum	AIR_CONDITION, NON_SMOKING, SMOKING_ALLOWED, EXTRA_LUGGAGE_SPACE, CHILD_SEAT, DISABLED_PEOPLE, PETS_ALLOWED, BIKE_MOUNT

TariffObject

Service type and pricing information

Field	Type	Description
tariffId	String	Service type UUID
name	String	Service type name
companyName	String	Driver company name
vehicleType	Enum	ECONOMY, CLASSIC, BUSINESS, LUXURY, etc.
tariffType	Enum	PRECISE, HOURLY
numberOfSeats	Integer	Number of passenger seats
paymentMethods	Array of Enum	Available payment methods: CASH, CREDIT_CARD, TERMINAL, THIRD_PARTY Important Notes: - The payment method 'CREDIT_CARD' is not available when creating orders via Operator API - For 'THIRD_PARTY' payment method, use a Partner access operator and their API token
currency	Enum	Currency code according to ISO 4217 standard
unitOfLength	Enum	METER, KILOMETER, MILE
minimumCharge	Number	Minimum trip cost
maximumCharge	Number	Maximum trip cost
flagDownFee	Number	Flag down fee (seat price)
perDistanceUnitFee	Number	Cost of a kilometer (mile) of a trip
perHourFee	Number	Cost of an hour of a trip
taximeterMode	Enum	TIME_AND_MILEAGE, TIME_OR_MILEAGE, TIME_HOURLY
speedBreakPoint	Number	Speed threshold (for taximeterMode = TIME_OR_MILEAGE)
tariffMode	Enum	DISABLED, AUTO, AUTO_FIXED_COST
driverCanSetCost	Boolean	Allow driver to add extra expenses
fixedFaresAvailable	Boolean	If true - prepared prices will be applied for fixed zones
fixedFareName	String	Fixed fare name
cost	Number	Estimated trip cost
fixedCost	Boolean	Fixed trip cost option
prepaidSupported	Boolean	If true - the trip was paid before it started (currently not supported)
asapBooking	Boolean	ASAP booking option
preBooking	Boolean	Pre-booking option
minimumPreBookingDelay	Integer	The minimum period for preorder (milliseconds)

OrderUpdateObject

Order status and driver location update

Field	Type	Description
driverId	String	Driver UUID
driverLocation	LocationObject	Driver location info like coordinates, speed, etc.
status	String	CANCELLED_BY_DISPATCH, CANCELLED_BY_DRIVER, CANCELLED_NO_PASSENGER, etc.

LocationObject

Location information

Field	Type	Description
accuracy	Number	Object estimated location radius, in meters
time	String	Time of location calculation according to RFC3339 standard
bearing	Number	The horizontal direction of the mobile device in degrees (0.0, 360.0]
speed	Number	Object speed (meters per second)
lat	Number	Object latitude
lng	Number	Object longitude

TripSummaryObject

Trip summary information

Field	Type	Description
createTime	String	Order creation time according to RFC3339 standard
pickupTime	String	Customer pickup time according to RFC3339 standard
dropoffTime	String	Customer dropoff time according to RFC3339 standard
currency	Enum	Currency code according to ISO 4217 standard
unitOfLength	Enum	METER, KILOMETER, MILE
tripDistance	Number	Trip distance in units specified in "unitOfLength" field
tripDuration	Integer	Trip duration in milliseconds
tripCost	Number	Estimated trip cost
extraCost	Number	Additional fees
finalCost	Number	Total trip cost with fees
payments	Array of PaymentObject	Trip payment info like payment method, amount, etc.
ratingByDriver	Integer	Customer's rating by the driver
pickupLocation	LatLngObject	Passenger pickup coordinates
dropoffLocation	LatLngObject	Passenger final dropoff coordinates
orderSource	Enum	PASSENGER_APP, DISPATCH_PANEL, DISPATCH_API

PaymentObject

Payment information

Field	Type	Description
time	String	Time of payment according to RFC3339 standard
amount	Number	Amount of money paid
method	Enum	CASH, CREDIT_CARD, TERMINAL, THIRD_PARTY

OrderStatusObject

Order status information

Field	Type	Description
status	String	CANCELLED_BY_DISPATCH, CANCELLED_BY_DRIVER, CANCELLED_NO_PASSENGER, etc.

VehicleObject

Vehicle information with location

Field	Type	Description
location	LocationObject	Driver location info like coordinates, accuracy, etc.
vehicleType	Enum	ECONOMY, CLASSIC, BUSINESS, LUXURY, etc.

OrderPrepareRequestObject

Request to prepare a new order

Field	Type	Description
waypoints	Array of WaypointObject	Geodata of pickup, intermediate, and drop-off points
unitOfLength	Enum	METER, KILOMETER, MILE
pickupTime	String	Pick up time for arrival according to RFC3339 standard
currency	Enum	Currency code according to ISO 4217 standard
specialCost	Number	Special price for the order
includedDistance	Number	Included in special price distance
includedDuration	Integer	Included in special price duration in millis

OrderPrepareResponseObject

Response from preparing a new order

Field	Type	Description
orderId	String	Order UUID
confirmationId	String	Identifier of the operation
orderPreparationData	OrderPreparationDataObject	Prepared data for order creation

OrderPreparationDataObject

Prepared data for order creation

Field	Type	Description
allTariffsTripEstimations	Array of TripEstimationObject	Trip estimations for different tariffs

TripEstimationObject

Trip estimation information

Field	Type	Description
cost	Number	Estimated trip cost
fixedCost	Boolean	Fixed trip cost option
priceMultiplier	Number	Price multiplier
tariffId	String	Service type UUID

TopupRequestObject

Request object for driver account topup

Field	Type	Description
money	Object	Money amount details
comment	String	Additional information about the topup transaction

WithdrawRequestObject

Request object for driver account withdrawal

Field	Type	Description
money	Object	Money amount details
comment	String	Reason for the withdrawal

CommitInvoiceRequestObject

Request object for committing a pending invoice

Field	Type	Description
invoiceId	String	Unique identifier of the invoice to commit

InvoiceObject

Invoice information

Field	Type	Description
invoiceId	String	Unique identifier for the invoice
status	String	Current status of the invoice (e.g. pending, committed)
type	String	Type of invoice (topup or withdraw)
amount	Number	Invoice amount
currency	String	Currency code (e.g. EUR)
comment	String	Additional information or reason for the invoice
createdAt	String	Invoice creation timestamp in RFC3339 format
updatedAt	String	Last update timestamp in RFC3339 format

OrderConfirmRequestObject

Request object for confirming an order

Field	Type	Description
confirmationId	String	Identifier of the operation
extraOptions	Array of Enum	Additional options for the order
client	CustomerObject	Customer info like name, UUID, image, etc.
notes	String	Text notes for an order
numberOfSeats	Integer	Number of seats needed
vehicleType	Enum	Type of vehicle
tariffType	Enum	Type of tariff
paymentMethods	Enum	Available payment methods
prepaid	Boolean	If true - the trip was paid before it started (currently not supported)
manualAssignDriver	String	Driver Id that is used for manual assign

OrderConfirmResponseObject

Response object for confirming an order

Field	Type	Description
orderId	String	Order UUID