> ## 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 Pressure Inspection

> Retrieve a list of vehicles that have not undergone tire pressure 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. This endpoint helps identify vehicles that require pressure inspection attention.



## OpenAPI

````yaml /api-reference/smarttire.json get /public/v1/customer/{customerId}/asset/tire/uninspected/pressure
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/pressure:
    get:
      tags:
        - /tire
      summary: List Vehicles Pending Pressure Inspection
      description: >-
        Retrieve a list of vehicles that have not undergone tire pressure
        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. This endpoint
        helps identify vehicles that require pressure 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 (`pressureEventDate` 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: 20
      responses:
        '200':
          description: >-
            200 response. List of vehicles whose pressure has not been inspected
            since a specified timestamp.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetUninspectedAssetsByPressureResponse'
        '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:
    GetUninspectedAssetsByPressureResponse:
      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: >-
                      Latest pressure 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'
                        description: >-
                          Array of POIs (Points of Interest) associated with the
                          vehicle's location.
                      address:
                        $ref: '#/components/schemas/Address'
                    required:
                      - latitude
                      - longitude
                      - timestamp
                  tires:
                    type: array
                    description: >-
                      Array of tire-related inspection data for each tire on the
                      vehicle.
                    items:
                      type: object
                      properties:
                        position:
                          $ref: '#/components/schemas/TirePosition'
                        positionIdentifier:
                          type: string
                        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
    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
    Address:
      type: object
      description: >-
        Address information derived from GPS coordinates via reverse geocoding.
        May be undefined if reverse geocoding was not performed or failed.
      properties:
        formattedAddress:
          type: string
          description: Full formatted address.
        road:
          type: string
          description: Street or road name.
        roadNumber:
          type: string
          description: Street or road number.
        city:
          type: string
          description: City name.
        postCode:
          type: string
          description: Postal code.
        country:
          type: string
          description: Country 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

````