Skip to main content
GET
/
public
/
v1
/
customer
/
{customerId}
/
asset
/
tire
/
uninspected
/
wear
List Vehicles Pending Wear Inspection
curl --request GET \
  --url https://public-api.masternautconnect.com/public/v1/customer/{customerId}/asset/tire/uninspected/wear \
  --header 'Authorization: <api-key>'
{
  "pageIndex": 0,
  "pageSize": 25,
  "totalPages": 10,
  "totalCount": 250,
  "resultCount": 25,
  "hasNextPage": true,
  "data": [
    {
      "asset": {
        "id": "<string>",
        "name": "<string>",
        "registration": "<string>",
        "formattedRegistration": "<string>",
        "vin": "<string>"
      },
      "wearEventDate": "2023-11-07T05:31:56Z",
      "location": {
        "latitude": 45.78337128368718,
        "longitude": 3.092814979143072,
        "timestamp": "2023-11-07T05:31:56Z",
        "pois": [
          {
            "locationId": "<string>",
            "locationName": "<string>",
            "locationCategory": "<string>"
          }
        ]
      },
      "tires": [
        {
          "position": {
            "axleNumber": 2,
            "tireCount": 4,
            "tireNumber": 2
          },
          "positionIdentifier": "<string>",
          "wearInspection": {
            "grooves": [
              {
                "grooveNumber": 1,
                "rtd": 2.1
              }
            ]
          },
          "inspectionStatus": "<string>",
          "regrooved": true,
          "retreaded": true
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Authorization header containing a Bearer token of the form Bearer [token], where [token] is a JWT used to authorize the request

Path Parameters

​
customerId
string
required

Query Parameters

​
groupId
string

Group identifier (alphanumeric). Use this to retrieve data for all vehicles within a specific group.

There are generally two types of API clients:

  1. MyCF web users, who must always provide a groupId when accessing the API;
  2. Customer-level API users, who can access data by providing only the customerId.
​
uninspectedSince
string<date-time>
required

Includes only vehicles whose last inspection (wearEventDate in the response) occurred before the specified timestamp, or that have never been inspected. Results are sorted in ascending order by inspection date (oldest first). Format: YYYY-MM-DDThh:mm:ss.sssZ.

Example:

"2025-07-01T00:00:00.000Z"

​
includeLocation
boolean
default:false

Whether to include the vehicle's last known GPS location in the response. Defaults to false.

️ Setting this to true may require additional backend resources to retrieve and enrich location data (e.g., GPS timestamp, optional POI information). If not strictly needed, it is recommended to leave this flag unset or set to false to improve response time and performance.

​
pageIndex
integer
default:0

Specifies the pagination page index. Pages are zero indexed, i.e. the first page has an index value of zero..

Required range: x >= 0
​
pageSize
integer
default:200

Specifies the number of items to include on a page. Must be specified if pageIndex has been specified.

Required range: x >= 1

Response

200 response. List of vehicles that have not undergone tire wear inspection since a specified timestamp.

​
pageIndex
number

The current page index (zero-based).

Example:

0

​
pageSize
number

The number of items per page.

Example:

25

​
totalPages
number

The total number of pages available.

Example:

10

​
totalCount
number

The total number of items available.

Example:

250

​
resultCount
number

The number of items returned in the current response.

Example:

25

​
hasNextPage
boolean

Indicates if there is a next page available.

​
data
object[]