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

# Find Nearest Vehicles

> Returns all the nearest vehicles to the search point. Details for a vehicle on a private journey are not returned. The number of vehicles returned is restricted to the maximum specified. The vehicles are ordered based on distance from the search point.<br/><br/>The search point can be specified as either latitude and longitude or as an address (at least one of roadNumber, road, city, postcode or country).



## OpenAPI

````yaml /api-reference/vehicle-tracking.json get /public/v1/customer/{customerId}/vehicle/nearest
openapi: 3.0.1
info:
  title: Vehicle Tracking
  description: >-
    A foundational pack delivering essential “track & trace” capability across
    your fleet.
  contact:
    name: Masternaut
    url: https://www.masternaut.com
    email: support@masternautconnect.com
  version: 124.0.2607160821
servers:
  - url: https://api.masternautconnect.com/connect-webservices/services
    description: Product Server
security:
  - basicAuth: []
tags:
  - name: /alert
    description: Alert history and notification management operations
  - name: /input
    description: Input usage operations for vehicles and drivers
  - name: /journey/detail
    description: Journey detail operations with vehicle and driver perspectives
  - name: /location
    description: Location management operations
  - name: /tokenInformation
    description: Token operations
  - name: /tracking/history
    description: Tracking history operations for vehicles and drivers
  - name: /tracking/journey
    description: Journey tracking and management operations
  - name: /tracking/live
    description: Live tracking operations
  - name: /vehicle
    description: Vehicle management operations
paths:
  /public/v1/customer/{customerId}/vehicle/nearest:
    get:
      tags:
        - /vehicle
      summary: Find Nearest Vehicles
      description: >-
        Returns all the nearest vehicles to the search point. Details for a
        vehicle on a private journey are not returned. The number of vehicles
        returned is restricted to the maximum specified. The vehicles are
        ordered based on distance from the search point.<br/><br/>The search
        point can be specified as either latitude and longitude or as an address
        (at least one of roadNumber, road, city, postcode or country).
      operationId: findNearestVehicles
      parameters:
        - name: customerId
          in: path
          required: true
          schema:
            type: string
        - name: lastMovedStartDateTime
          in: query
          description: >-
            Start date and time for filtering vehicles that moved after this
            time. Format: yyyy-MM-dd'T'HH:mm:ss in UTC.
          required: false
          schema:
            type: string
            description: >-
              Start date and time for filtering vehicles that moved after this
              time. Format: yyyy-MM-dd'T'HH:mm:ss in UTC.
            format: date-time
        - name: lastMovedEndDateTime
          in: query
          description: >-
            End date and time for filtering vehicles that moved before this
            time. Format: yyyy-MM-dd'T'HH:mm:ss in UTC.
          required: false
          schema:
            type: string
            description: >-
              End date and time for filtering vehicles that moved before this
              time. Format: yyyy-MM-dd'T'HH:mm:ss in UTC.
            format: date-time
        - name: longitude
          in: query
          description: >-
            Longitude coordinate of the center point for the search radius.
            Required if using coordinate-based search.
          required: false
          schema:
            type: number
            description: >-
              Longitude coordinate of the center point for the search radius.
              Required if using coordinate-based search.
            format: double
        - name: latitude
          in: query
          description: >-
            Latitude coordinate of the center point for the search radius.
            Required if using coordinate-based search.
          required: false
          schema:
            type: number
            description: >-
              Latitude coordinate of the center point for the search radius.
              Required if using coordinate-based search.
            format: double
        - name: radius
          in: query
          description: Search radius in kilometers from the center point.
          required: true
          schema:
            type: number
            description: Search radius in kilometers from the center point.
            format: double
        - name: maximumResultsToReturn
          in: query
          description: Maximum number of vehicle results to return.
          required: true
          schema:
            type: integer
            description: Maximum number of vehicle results to return.
            format: int32
        - name: road
          in: query
          description: >-
            Road name or street name for address-based search. At least one
            address component required if using address-based search.
          required: false
          schema:
            type: string
            description: >-
              Road name or street name for address-based search. At least one
              address component required if using address-based search.
        - name: roadNumber
          in: query
          description: >-
            Road number or house number for address-based search. At least one
            address component required if using address-based search.
          required: false
          schema:
            type: string
            description: >-
              Road number or house number for address-based search. At least one
              address component required if using address-based search.
        - name: city
          in: query
          description: >-
            City name for address-based search. At least one address component
            required if using address-based search.
          required: false
          schema:
            type: string
            description: >-
              City name for address-based search. At least one address component
              required if using address-based search.
        - name: country
          in: query
          description: >-
            Country name for address-based search. At least one address
            component required if using address-based search.
          required: false
          schema:
            type: string
            description: >-
              Country name for address-based search. At least one address
              component required if using address-based search.
        - name: postCode
          in: query
          description: >-
            Postal code or postcode for address-based search. At least one
            address component required if using address-based search.
          required: false
          schema:
            type: string
            description: >-
              Postal code or postcode for address-based search. At least one
              address component required if using address-based search.
      responses:
        '200':
          description: Nearest vehicles found successfully.
          content:
            application/json;charset=UTF-8:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/NearestVehiclesSearchResultDto'
components:
  schemas:
    NearestVehiclesSearchResultDto:
      type: object
      properties:
        id:
          type: string
          description: Vehicle identifier
        name:
          type: string
          description: Vehicle friendly name
        registration:
          type: string
          description: Vehicle registration
        straightLineDistanceKilometers:
          type: number
          description: Distance to the vehicle in kilometers
          format: double
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````