Skip to main content
POST
/
api
/
v1
/
fleets
/
{assetProviderCountryCode}
/
{assetProviderCode}
Find vehicles
curl --request POST \
  --url https://api.smartmove.eu/m2m/api/v1/fleets/{assetProviderCountryCode}/{assetProviderCode} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "searchText": "<string>",
  "pagination": {
    "pageSize": 100,
    "page": 0
  },
  "filters": [
    {
      "field": "status.lastUpdated",
      "operation": "IN",
      "value": "<unknown>"
    }
  ],
  "sorting": [
    {
      "by": "status.lastUpdated",
      "direction": "ASC"
    }
  ]
}
'
{
  "items": [
    {
      "asset": {
        "id": "AT*ABC*V1000000",
        "assetProviderCountryCode": "AT",
        "assetProviderCode": "ABC",
        "blobUuid": "a79abfff-bcdb-4bd1-b999-af29fe3d9056",
        "defaultImage": "https://some.storage.website/image.png"
      },
      "information": {
        "vin": "0F0EAATTRBPC3CDBB",
        "vendor": "BMW",
        "model": "Zoe",
        "variant": "Long Range",
        "licensePlate": "W-53A",
        "fuelType": "DIESEL",
        "seats": 5,
        "gear": "Manual",
        "firstRegistrationDate": "2023-08-17",
        "buildYear": 2023
      },
      "status": {
        "lastUpdated": "2023-08-17T18:19:22.874Z",
        "location": {
          "lat": 123,
          "lng": 123
        },
        "isCharging": true,
        "isLocked": true,
        "windowsClosed": true,
        "doorsClosed": true,
        "engineActive": true,
        "odometer": 123,
        "reach": 123,
        "fuelLevel": 123,
        "headlightsActive": true,
        "immobilizerActive": true,
        "tirePressureFrontLeft": 123,
        "tirePressureFrontRight": 123,
        "tirePressureRearLeft": 123,
        "tirePressureRearRight": 123
      }
    }
  ],
  "pagination": {
    "pageSize": 100,
    "pageNumber": 0,
    "totalEntries": 1
  }
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

assetProviderCountryCode
string
required

The two-letter country code of the asset provider the vehicles belong to

Required string length: 2
assetProviderCode
string
required

The three-character code of the asset provider the vehicles belong to

Required string length: 3

Body

application/json

The request body enables to paginate through all the vehicles, as well as to filter and search for vehicles fulfilling certain requirements

searchText
string

The given search text filters the vehicles including the text in one of the following fields:

  • vin
  • license plate
  • vendor
  • model
  • variant
pagination
object

Request what page is wanted to be retrieved

filters
object[]

Allows to filter vehicles for the given requirements. All filters are combined with AND operators.

sorting
object[]

Allows to sort vehicles by given fields in order of items in array.

Response

Paginated response of the vehicles where the filters apply

items
object[]
required
pagination
object
required