Skip to main content

How to Get a Vehicle

Learn how to get a Dott vehicle details.

Individual Vehicle​

There are two ways to get information about an individual vehicle:

  • Through the GetVehicle API endpoint if you have a vehicleId.
  • Through the SearchVehicle API endpoint if you need to start a trip from the QR code scanned on a Dott's vehicle but you don't have its vehicleId yet.

If there are no errors both API's return a valid Vehicle resource.

List of Vehicles​

You may also want to pull in the list of vehicles. Send a request to the ListVehicles API endpoint and add the query parameters to filter out the output.

Here is an example of how to get a list of all the currently riding bicycles:

curl --location --request GET \
  --header 'Content-Type: application/json' \
  --header 'User-Agent: {COMPANY_NAME}' \
  --header 'Authorization: Bearer {JWT}' \
  'https://web.maas.api.staging.ridedott.com/v1alpha2/?vehicleTypes=VEHICLE_TYPE_BICYCLE&state=VEHICLE_STATE_ON_TRIP'

As an alternative use our GBFS service which provides an API for retrieving a list of all available vehicles in a specified region:

curl --location --request GET \
  --header 'Content-Type: application/json' \
  --header 'User-Agent: {COMPANY_NAME}' \
  --header 'Authorization: Bearer {JWT}' \
  'https://gbfs.api.staging.ridedott.com/v2/{regionName}/free_bike_status.json'
info

Learn how MaaS API depends on GBFS.