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

> Get the latest tire pressure and wear inspection data for one or more vehicles. You can filter by specific vehicle (assetId) or group, specify inspection types, include location information, and apply pagination. This endpoint returns comprehensive tire condition information including pressure, temperature, wear measurements, and defect status.



## OpenAPI

````yaml /api-reference/smarttire.json get /public/v1/customer/{customerId}/asset/tire
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:
    get:
      tags:
        - /tire
      summary: Tire events
      description: >-
        Get the latest tire pressure and wear inspection data for one or more
        vehicles. You can filter by specific vehicle (assetId) or group, specify
        inspection types, include location information, and apply pagination.
        This endpoint returns comprehensive tire condition information including
        pressure, temperature, wear measurements, and defect status.
      parameters:
        - name: customerId
          in: path
          required: true
          schema:
            type: string
        - name: assetId
          description: >-
            Identifier (alphanumeric) of a vehicle.. If neither `assetId` nor
            `groupId` is provided, data for **all vehicles accessible to the
            user under the specified customer** will be returned.
          in: query
          required: false
          schema:
            type: string
        - name: groupId
          description: >-
            Group identifier (alphanumeric). Use this to retrieve data for all
            vehicles within a specific group. If neither `assetId` nor `groupId`
            is provided, data for **all vehicles accessible to the user under
            the specified customer** will be returned.
          in: query
          required: false
          schema:
            type: string
        - name: inspectionTypes
          description: Comma separated list of includes, e.g. 'TIRE_WEAR, TIRE_PRESSURE
          in: query
          required: true
          schema:
            type: array
            items:
              type: string
            example:
              - TIRE_WEAR
              - TIRE_PRESSURE
          style: form
          explode: false
        - name: includeLocation
          description: >-
            Whether to include each vehicle's last known location; the default
            is false
          in: query
          required: false
          schema:
            type: boolean
        - name: sinceDate
          description: >-
            Only include vehicles whose tire wear/pressure have been updated
            since this date and time
          in: query
          required: false
          schema:
            type: string
            format: date-time
        - 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
            minimum: 1
            default: 200
      responses:
        '200':
          description: 200 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TireDataResponse'
        '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:
    TireDataResponse:
      type: object
      allOf:
        - $ref: '#/components/schemas/PaginationInfo'
        - type: object
          properties:
            data:
              type: array
              items:
                type: object
                properties:
                  asset:
                    $ref: '#/components/schemas/VehicleAsset'
                  pressureEventDate:
                    type: string
                    format: date-time
                    description: >-
                      Date of the last tire pressure inspection event, in UTC,
                      in format of YYYY-MM-DDThh:mm:ss
                  wearEventDate:
                    type: string
                    format: date-time
                    description: >-
                      Date of the last tire wear inspection event, in UTC, in
                      format of YYYY-MM-DDThh:mm:ss
                  tires:
                    type: array
                    description: >-
                      List of tires with their respective pressure and wear
                      inspection data.
                    items:
                      type: object
                      properties:
                        position:
                          $ref: '#/components/schemas/TirePosition'
                        positionIdentifier:
                          type: string
                          description: Unique identifier for the tire position.
                        pressureInspection:
                          type: object
                          properties:
                            pressure:
                              type: number
                              example: 800000
                              description: Measured tire pressure in pascals (Pa).
                            normalizedPressure:
                              description: >-
                                Tire pressure adjusted to a reference
                                temperature of 20°C, in pascals (Pa).
                              type: number
                              example: 790000
                            temperature:
                              description: >-
                                Tire temperature in degrees Celsius (°C) at the
                                time of inspection.
                              type: number
                              example: 45
                        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
                  location:
                    type: object
                    properties:
                      latitude:
                        type: number
                        example: 45.78337128368718
                      longitude:
                        type: number
                        example: 3.092814979143072
                      pois:
                        type: array
                        description: >-
                          List of points of interest (POIs) near the vehicle's
                          last known location.
                        items:
                          $ref: '#/components/schemas/POI'
    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.
    POI:
      type: object
      description: Point of Interest (POI) related to the vehicle's location
      properties:
        locationId:
          type: string
        locationName:
          type: string
        locationCategory:
          type: string
  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

````