> ## 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 Defect Events > Get tire defect history for one or more vehicles within a specified date range (not exceeding 6 months). Filter by severity level, specific vehicle (assetId), or group. Returns comprehensive defect information including category, type, entity type, severity, expected resolution date, and detailed properties such as pressure readings, wear measurements, or configuration issues. ## OpenAPI ````yaml /api-reference/smarttire.json get /public/v1/customer/{customerId}/asset/tire/defect/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/tire/defect/history: get: tags: - /tire summary: Tire Defect Events description: >- Get tire defect history for one or more vehicles within a specified date range (not exceeding 6 months). Filter by severity level, specific vehicle (assetId), or group. Returns comprehensive defect information including category, type, entity type, severity, expected resolution date, and detailed properties such as pressure readings, wear measurements, or configuration issues. parameters: - name: customerId in: path required: true schema: type: string - name: startDate description: >- The result will include defects that occurred between startDateTime and endDateTime, not exceeding 6 months in: query required: true schema: type: string format: date-time - name: endDate description: >- The result will include defects that occurred between startDateTime and endDateTime, not exceeding 6 months in: query required: true schema: type: string format: date-time - name: severities description: >- Filter by severity of the defect. If not provided, all severities will be returned. in: query required: false schema: type: array items: type: string enum: - ATTENTION - MINOR - MODERATE - MAJOR - CRITICAL - INFORMATION - NOT_INSTALLED - OTHER_ACTION - 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: 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/GetTireDefectsResponse' '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: GetTireDefectsResponse: type: object allOf: - $ref: '#/components/schemas/PaginationInfo' - type: object properties: data: type: array items: type: object properties: asset: $ref: '#/components/schemas/VehicleAsset' category: type: string description: Classification of the defect enum: - WEAR - PRESSURE - TEMPERATURE - CONFIG_WEAR - CONFIG_PRESSURE - NOT_INSTALLED_PRESSURE - NOT_INSTALLED_WEAR - MANUAL type: type: string description: Type of the defect, e.g. WEAR, CONICITY, etc. entityType: type: string enum: - TIRE - AXLE - VEHICLE description: >- Type of the entity associated with the defect, e.g. TIRE, AXLE, VEHICLE inProgress: type: boolean description: >- Indicates whether the defect is still active on the vehicle. This value is set to true when the defect is open, and false once it has been fixed or closed creationDate: type: string format: date-time description: The date and time when the defect was first reported updateDate: type: string format: date-time description: The date and time when the defect was last updated severity: type: string description: >- Severity of the defect, e.g. INFORMATION, MODERATE, CRITICAL severityCode: type: number example: 2 description: Severity code of the defect properties: type: object properties: dueDate: type: string format: date-time description: >- The date and time when the defect is expected to become critical positions: type: array items: type: object properties: axleNumber: type: number example: 1 description: Axle number associated with the tire position tireCount: type: number example: 2 description: Number of tires on the axle tireNumber: type: number example: 1 description: Tire number on the axle, starting from 1 positionIdentifier: type: string description: Unique identifier for the tire position pressure: type: number example: 800000 description: Measured tire pressure in pascals (Pa) normalizedPressure: type: number example: 790000 description: >- Tire pressure adjusted to a reference temperature of 20°C, in pascals (Pa) temperature: type: number example: 45 description: >- Tire temperature in degrees Celsius (°C) at the time of inspection conicity: type: number example: 0.00415 description: Measurement of wear in mm grooveHeightDifference: type: number example: 0.23 description: >- Difference in groove height, used to assess inconsistency 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 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 ````