> ## Documentation Index
> Fetch the complete documentation index at: https://docs.connectedfleet.michelin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tire Inspection

Tire inspection tracking helps fleet managers identify vehicles that are overdue for pressure or wear inspections. By monitoring inspection compliance, you can ensure all vehicles meet safety standards and maintenance schedules.

## Overview

The Smart Tire API provides two endpoints to identify vehicles pending inspection:

* **[List Vehicles Pending Pressure Inspection](/api-reference/tire/list-vehicles-pending-pressure-inspection)** - Find vehicles that haven't had a pressure check since a specified date
* **[List Vehicles Pending Wear Inspection](/api-reference/tire/list-vehicles-pending-wear-inspection)** - Find vehicles that haven't had a wear inspection since a specified date

Both endpoints return vehicles sorted by inspection date in ascending order (oldest first), making it easy to prioritize the most overdue vehicles.

## How It Works

Use the `uninspectedSince` parameter to specify a cutoff timestamp. The API returns vehicles where:

* The last inspection occurred **before** the specified timestamp, OR
* The vehicle has **never been inspected**

<Note>
  Vehicles that have never been inspected are included in the results with a null or missing inspection date, ensuring you don't miss any uninspected vehicles in your fleet.
</Note>

## Response Data

Each response includes:

| Field                                 | Description                                           |
| ------------------------------------- | ----------------------------------------------------- |
| `asset`                               | Vehicle identification (ID, name, registration, VIN)  |
| `pressureEventDate` / `wearEventDate` | Date of the last inspection (null if never inspected) |
| `tires`                               | Array of tire data from the most recent inspection    |
| `location`                            | Last known GPS location (optional)                    |

### Vehicle Information

The `asset` object contains vehicle identification details:

| Field                   | Description                                      |
| ----------------------- | ------------------------------------------------ |
| `id`                    | Unique vehicle identifier                        |
| `name`                  | Vehicle name                                     |
| `registration`          | Raw registration string                          |
| `formattedRegistration` | Standardized registration for system integration |
| `vin`                   | Vehicle Identification Number                    |

### Location Data

When `includeLocation=true`, the response includes the vehicle's last known position:

| Field       | Description                                              |
| ----------- | -------------------------------------------------------- |
| `latitude`  | GPS latitude coordinate                                  |
| `longitude` | GPS longitude coordinate                                 |
| `timestamp` | When the GPS position was recorded                       |
| `pois`      | Nearby Points of Interest (depots, customer sites, etc.) |
| `address`   | Reverse-geocoded address (pressure endpoint only)        |

<Warning>
  **Performance consideration**

  Enabling `includeLocation=true` requires additional backend processing to retrieve and enrich location data. If location information is not needed, leave this parameter unset or set to `false` to improve response times.
</Warning>

## Filtering Options

### By Group

Filter results to vehicles within a specific group:

```bash theme={null}
curl --request GET \
  --url 'https://public-api.masternautconnect.com/public/v1/customer/{customerId}/asset/tire/uninspected/pressure?uninspectedSince=2025-01-01T00:00:00Z&groupId={groupId}' \
  --header 'Authorization: Token <your-api-token>'
```

<Info>
  **API client types**

  There are two types of API clients:

  1. **myConnectedFleet web users** — Must always provide a `groupId` when accessing the API
  2. **Customer-level API users** — Can access data by providing only the `customerId`
</Info>

## Use Cases

### Daily Inspection Compliance Check

Find all vehicles that haven't had a pressure check in the last 7 days:

```bash theme={null}
curl --request GET \
  --url 'https://public-api.masternautconnect.com/public/v1/customer/{customerId}/asset/tire/uninspected/pressure?uninspectedSince=2025-01-14T00:00:00Z' \
  --header 'Authorization: Token <your-api-token>'
```

### Monthly Wear Inspection Schedule

Find all vehicles that haven't had a wear inspection in the last 30 days:

```bash theme={null}
curl --request GET \
  --url 'https://public-api.masternautconnect.com/public/v1/customer/{customerId}/asset/tire/uninspected/wear?uninspectedSince=2024-12-21T00:00:00Z' \
  --header 'Authorization: Bearer <your-api-token>'
```

### Locate Uninspected Vehicles

Find uninspected vehicles and include their current location to plan service routes:

```bash theme={null}
curl --request GET \
  --url 'https://public-api.masternautconnect.com/public/v1/customer/{customerId}/asset/tire/uninspected/pressure?uninspectedSince=2025-01-01T00:00:00Z&includeLocation=true' \
  --header 'Authorization: Bearer <your-api-token>'
```

### Never-Inspected Vehicles

To find vehicles that have never been inspected, set `uninspectedSince` to a future date. All vehicles with no inspection history will be returned:

```bash theme={null}
curl --request GET \
  --url 'https://public-api.masternautconnect.com/public/v1/customer/{customerId}/asset/tire/uninspected/wear?uninspectedSince=2030-01-01T00:00:00Z' \
  --header 'Authorization: Bearer <your-api-token>'
```

## Pagination

Both endpoints support pagination for large fleets:

| Parameter   | Default                    | Description                |
| ----------- | -------------------------- | -------------------------- |
| `pageIndex` | 0                          | Zero-based page number     |
| `pageSize`  | 20 (pressure) / 200 (wear) | Number of results per page |

The response includes pagination metadata:

| Field         | Description                                 |
| ------------- | ------------------------------------------- |
| `pageIndex`   | Current page number                         |
| `pageSize`    | Results per page                            |
| `totalPages`  | Total number of pages                       |
| `totalCount`  | Total number of vehicles matching the query |
| `resultCount` | Number of vehicles in the current response  |
| `hasNextPage` | Whether more pages are available            |

### Paginating Through Results

```bash theme={null}
# First page
curl --request GET \
  --url 'https://public-api.masternautconnect.com/public/v1/customer/{customerId}/asset/tire/uninspected/pressure?uninspectedSince=2025-01-01T00:00:00Z&pageIndex=0&pageSize=50' \
  --header 'Authorization: Bearer <your-api-token>'

# Second page
curl --request GET \
  --url 'https://public-api.masternautconnect.com/public/v1/customer/{customerId}/asset/tire/uninspected/pressure?uninspectedSince=2025-01-01T00:00:00Z&pageIndex=1&pageSize=50' \
  --header 'Authorization: Bearer <your-api-token>'
```

## Integration Patterns

### Automated Compliance Monitoring

1. Schedule a daily job to query uninspected vehicles
2. Compare against your inspection policy (e.g., pressure every 7 days, wear every 30 days)
3. Generate alerts or work orders for overdue vehicles
4. Track compliance rates over time

### Service Route Planning

1. Query uninspected vehicles with `includeLocation=true`
2. Use GPS coordinates to cluster vehicles by location
3. Plan efficient service routes to inspect multiple vehicles
4. Prioritize based on how overdue each vehicle is (results are sorted oldest first)

### Dashboard Integration

1. Query both pressure and wear uninspected endpoints
2. Display counts and lists in your fleet management dashboard
3. Highlight vehicles that are overdue for both inspection types
4. Provide drill-down to individual vehicle details