SOsoldo
Vehicles

Search Vehicle

Changed on

Endpoint to find Vehicle resources using filtering parameters.

get/business/v2/vehicles

Request

Query parameters

textstring

A text to be searched on the number plate and description field.

Example:something
idsstring[]

The IDs of the vehicles to search.

[
  "776f5018-07e5-426b-a426-8b23fa1e985d"
]
pinteger

It indicates the specific page to display (the counter starts from zero).

Example:3
sinteger

It indicates the number of items per page.

Example:25
d'ASC' | 'DESC'

It indicates how the pages are ordered.

Example:DESC
propsstring[]

It indicates the sorting direction applied to the above parameters. To apply a sorting on multiple parameters, set as many times the props parameter in the request.

[
  "creationTime"
]

Response

The returned array contains Vehicle resources.

totalinteger

It represents the total number of available items in the list.

pagesinteger

It represents the total number of available pages.

page_sizeinteger

It represents the number of items per page.

current_pageinteger

It indicates the current page (the counter starts from zero).

results_sizeinteger

It indicates the size of the array results.

Example response

{
  "total": 168,
  "pages": 7,
  "page_size": 25,
  "results_size": 25,
  "results": [
    {
      "id": "7bf79328-a7ae-4222-aa54-091ff7f429a7",
      "number_plate": "AA000BB",
      "description": "Employee electric vehicle",
      "creation_time": "2017-06-01T12:48:40Z",
      "last_update_time": "2017-06-01T12:48:40Z",
      "card_ids": [
        "7bf79328-a7ae-4222-aa54-091ff7f429a7",
        "2d65bd5e-3fdf-4002-b166-bde7fb8863fa"
      ],
      "reimbursement_rate": 0.45,
      "mileage": 125000
    }
  ]
}

Changes