> ## 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 Wear Events

> Get historical tire wear measurements and inspection data for a specific vehicle and Identifier of a vehicle. Retrieve data within a specified date range with mandatory start and end dates and optional pagination. Returns tread depth measurements by groove, inspection status, and additional tire condition information for each tire on the vehicle.



## OpenAPI

````yaml /api-reference/smarttire.json get /public/v1/customer/{customerId}/asset/{assetId}/tire/wear/history
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/{assetId}/tire/wear/history:
    get:
      tags:
        - /tire
      summary: Tire Wear Events
      description: >-
        Get historical tire wear measurements and inspection data for a specific
        vehicle and Identifier of a vehicle. Retrieve data within a specified
        date range with mandatory start and end dates and optional pagination.
        Returns tread depth measurements by groove, inspection status, and
        additional tire condition information for each tire on the vehicle.
      parameters:
        - name: customerId
          in: path
          required: true
          schema:
            type: string
        - name: assetId
          description: Identifier (alphanumeric) of a vehicle.
          in: path
          required: true
          schema:
            type: string
        - name: startDate
          description: >-
            Only events occurring on or after this date will be included in the
            response
          in: query
          required: true
          schema:
            type: string
        - name: endDate
          description: >-
            Only events occurring before this date will be included in the
            response
          in: query
          required: true
          schema:
            type: string
        - name: pageIndex
          description: >-
            Specifies the pagination page index. Pages are zero indexed, i.e.
            the first page has an index value of zero.
          in: query
          required: false
          schema:
            type: number
            example: 1
        - name: pageSize
          description: >-
            Specifies the number of items to include on a page. Must be
            specified if pageIndex has been specified.
          in: query
          required: false
          schema:
            type: number
            example: 50
      responses:
        '200':
          description: 200 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTireWearResponse'
        '400':
          description: 400 response, bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: 401 response, not authorized or no valid token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: 403 response, Forbidden don't have access to the feature
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - stAuthorizer: []
components:
  schemas:
    GetTireWearResponse:
      type: object
      allOf:
        - $ref: '#/components/schemas/PaginationInfo'
        - type: object
          properties:
            data:
              type: object
              properties:
                asset:
                  $ref: '#/components/schemas/VehicleAsset'
                events:
                  type: array
                  items:
                    type: object
                    properties:
                      eventDate:
                        type: string
                        format: date-time
                      tires:
                        type: array
                        items:
                          type: object
                          properties:
                            position:
                              $ref: '#/components/schemas/TirePosition'
                            positionIdentifier:
                              type: string
                            inspectionStatus:
                              type: string
                              description: Status of the tire inspection
                              enum:
                                - MOUNT_CHANGE_SUSPICION
                                - INVALID_PROJECTION
                                - MISSING_POSITION
                                - INVALID_UNDERLAYER
                                - POSITION_PASSAGE_TOO_OLD
                                - MOUNT_NEVER_SEEN
                                - POSITION_NEVER_SEEN
                                - VEHICLE_NEVER_SEEN
                                - DATE_OUT_OF_PROJECTION_PERIOD
                                - UNSURE_WITHOUT_PASSAGE_DATE
                                - NO_PROJECTION_DATA
                                - OK
                            regrooved:
                              type: boolean
                            retreaded:
                              type: boolean
                            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
                                    format: float
                                    description: Remaining tread depth
    ErrorResponse:
      type: object
      properties:
        errorCode:
          type: number
        errorMessage:
          type: string
      required:
        - errorCode
        - errorMessage
    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
    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

````