> ## 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.

# List Vehicles Pending Wear Inspection

> Retrieve a list of vehicles that have not undergone tire wear inspection since a specified timestamp, or have never been inspected. Results are sorted by inspection date in ascending order (oldest first). Optionally include the vehicle's last known GPS location and address information. This endpoint helps identify vehicles that require wear inspection attention.



## OpenAPI

````yaml /api-reference/smarttire.json get /public/v1/customer/{customerId}/asset/tire/uninspected/wear
openapi: 3.0.1
info:
  title: public-api
  description: Public API Gateway
  version: '2025-12-17T15:30:00.000Z'
servers:
  - url: https://public-api.masternautconnect.com/
security: []
paths:
  /public/v1/customer/{customerId}/asset/tire/uninspected/wear:
    get:
      tags:
        - /tire
      summary: List Vehicles Pending Wear Inspection
      description: >-
        Retrieve a list of vehicles that have not undergone tire wear inspection
        since a specified timestamp, or have never been inspected. Results are
        sorted by inspection date in ascending order (oldest first). Optionally
        include the vehicle's last known GPS location and address information.
        This endpoint helps identify vehicles that require wear inspection
        attention.
      parameters:
        - name: customerId
          in: path
          required: true
          schema:
            type: string
        - name: groupId
          description: >-
            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`.
          in: query
          required: false
          schema:
            type: string
        - name: uninspectedSince
          in: query
          description: >-
            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`.
          required: true
          schema:
            type: string
            format: date-time
            example: '2025-07-01T00:00:00.000Z'
        - name: includeLocation
          in: query
          description: >-
            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.
          required: false
          schema:
            type: boolean
            default: false
        - name: pageIndex
          in: query
          description: >-
            Specifies the pagination page index. Pages are zero indexed, i.e.
            the first page has an index value of zero..
          required: false
          schema:
            type: integer
            minimum: 0
            default: 0
        - name: pageSize
          in: query
          description: >-
            Specifies the number of items to include on a page. Must be
            specified if pageIndex has been specified.
          required: false
          schema:
            type: integer
            minimum: 1
            default: 200
      responses:
        '200':
          description: >-
            200 response. List of vehicles that have not undergone tire wear
            inspection since a specified timestamp.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetUninspectedAssetsByWearResponse'
        '400':
          description: >-
            Invalid input parameters (e.g., missing required fields or invalid
            format)
        '404':
          description: Customer not found or no matching vehicles found
        '500':
          description: Internal server error
      security:
        - stAuthorizer: []
components:
  schemas:
    GetUninspectedAssetsByWearResponse:
      type: object
      allOf:
        - $ref: '#/components/schemas/PaginationInfo'
        - type: object
          properties:
            data:
              type: array
              items:
                type: object
                properties:
                  asset:
                    $ref: '#/components/schemas/VehicleAsset'
                  wearEventDate:
                    type: string
                    format: date-time
                    description: >-
                      Latest wear inspection date (optional). This field may be
                      missing or null for vehicles that have never been
                      inspected. Format: YYYY-MM-DDThh:mm:ss.sssZ.
                  location:
                    type: object
                    description: >-
                      Last known GPS location of the vehicle, including the
                      timestamp and optional POI (Point of Interest)
                      information.
                    properties:
                      latitude:
                        type: number
                        example: 45.78337128368718
                        format: float
                      longitude:
                        type: number
                        example: 3.092814979143072
                        format: float
                      timestamp:
                        type: string
                        format: date-time
                        description: >-
                          UTC timestamp when this GPS location was recorded.
                          Format: YYYY-MM-DDThh:mm:ss.sssZ.
                      pois:
                        type: array
                        items:
                          $ref: '#/components/schemas/POI'
                    required:
                      - latitude
                      - longitude
                      - timestamp
                  tires:
                    type: array
                    items:
                      type: object
                      properties:
                        position:
                          $ref: '#/components/schemas/TirePosition'
                        positionIdentifier:
                          type: string
                        wearInspection:
                          type: object
                          properties:
                            grooves:
                              type: array
                              items:
                                type: object
                                properties:
                                  grooveNumber:
                                    description: >-
                                      An index starting from 1 that identifies a
                                      specific tread groove on the tire, used to
                                      distinguish measurements from different
                                      grooves
                                    type: number
                                    example: 1
                                  rtd:
                                    type: number
                                    example: 2.1
                                    description: Remaining tread depth (m)
                        inspectionStatus:
                          description: Status of the tire inspection
                          type: string
                        regrooved:
                          description: Indicates if the tire has been regrooved
                          type: boolean
                        retreaded:
                          description: Indicates if the tire has been retreaded
                          type: boolean
    PaginationInfo:
      type: object
      properties:
        pageIndex:
          type: number
          example: 0
          description: The current page index (zero-based).
        pageSize:
          type: number
          example: 25
          description: The number of items per page.
        totalPages:
          type: number
          example: 10
          description: The total number of pages available.
        totalCount:
          type: number
          example: 250
          description: The total number of items available.
        resultCount:
          type: number
          example: 25
          description: The number of items returned in the current response.
        hasNextPage:
          type: boolean
          description: Indicates if there is a next page available.
    VehicleAsset:
      type: object
      description: >-
        Basic vehicle identification information. This object exclusively
        represents static asset-level attributes such as ID, name, registration,
        and VIN, and does not include any dynamic tire inspection data such as
        pressure, wear, or temperature.
      properties:
        id:
          type: string
          description: Unique identifier of the vehicle
        name:
          type: string
          description: Name of the vehicle
        registration:
          type: string
          description: >-
            The raw vehicle registration string, typically reflecting how it was
            originally provided. This field is not guaranteed to follow a
            standardized format and is intended for reference purposes only. For
            consistent identification and integration with external systems, use
            'formattedRegistration' instead.
        formattedRegistration:
          type: string
          description: >-
            The formatted vehicle registration used in MyCF as the
            'serialNumber'. Third-party systems using the Smart Tire Public API
            can use this field to map vehicles to their corresponding entries in
            their own systems.
        vin:
          type: string
      required:
        - id
        - name
    POI:
      type: object
      description: Point of Interest (POI) related to the vehicle's location
      properties:
        locationId:
          type: string
        locationName:
          type: string
        locationCategory:
          type: string
    TirePosition:
      type: object
      properties:
        axleNumber:
          type: number
          example: 2
          description: >-
            The number of the axle on the vehicle, starting from 1 for the front
            axle.
        tireCount:
          type: number
          example: 4
          description: Total number of tires on the axle.
        tireNumber:
          type: number
          example: 2
          description: >-
            The number of the tire on the axle, starting from 1 on the right
            side when facing forward.
  securitySchemes:
    stAuthorizer:
      type: apiKey
      name: Authorization
      description: >-
        Authorization header containing a Bearer token of the form Bearer
        [token], where [token] is a JWT used to authorize the request
      in: header
      x-amazon-apigateway-authtype: Custom authorization scheme using Masternauth
      x-amazon-apigateway-authorizer:
        type: request
        identitySource: method.request.header.Authorization, context.identity.sourceIp
        authorizerCredentials: arn:aws:iam::${aws_account}:role/mn_st_public_api_invoke_lambda_role
        authorizerUri: >-
          arn:aws:apigateway:eu-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:eu-west-2:${aws_account}:function:mn_st_public_api_masternauth_authorizer_lambda_${env}/invocations
        authorizerResultTtlInSeconds: 300

````