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

# Live Position Latest AEMP

> Returns the latest live position and status for a vehicle in AEMP format. The live position for a vehicle on a private journey is not returned. By default vehicles which have a status of SOLD are not included in the response.<br/><br/>This endpoint can be used to return details for only those vehicles where tracking data has been processed since a specified processed date/time.<br/><br/>If fromDateTime is specified, then only vehicles where tracking information has been processed since the specified date/time are included in the output response. An error is returned if the value specified for fromDateTime is more than one day in the past. No details are returned if the value specified for fromDateTime is a future date.<br/><br/><b>Request Limit:</b><br/>The request limit on this endpoint is one request every 15 seconds. You will receive an HTTP status code of 429 (too many requests) and no details will be returned if you exceed this restriction.



## OpenAPI

````yaml /api-reference/vehicle-tracking.json get /public/v1/customer/{customerId}/tracking/live/latest/aemp
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}/tracking/live/latest/aemp:
    get:
      tags:
        - /tracking/live
      summary: Live Position Latest AEMP
      description: >-
        Returns the latest live position and status for a vehicle in AEMP
        format. The live position for a vehicle on a private journey is not
        returned. By default vehicles which have a status of SOLD are not
        included in the response.<br/><br/>This endpoint can be used to return
        details for only those vehicles where tracking data has been processed
        since a specified processed date/time.<br/><br/>If fromDateTime is
        specified, then only vehicles where tracking information has been
        processed since the specified date/time are included in the output
        response. An error is returned if the value specified for fromDateTime
        is more than one day in the past. No details are returned if the value
        specified for fromDateTime is a future date.<br/><br/><b>Request
        Limit:</b><br/>The request limit on this endpoint is one request every
        15 seconds. You will receive an HTTP status code of 429 (too many
        requests) and no details will be returned if you exceed this
        restriction.
      operationId: getLatestLiveStatusAemp
      parameters:
        - name: customerId
          in: path
          required: true
          schema:
            type: string
        - name: vehicleIds
          in: query
          description: Comma separated list of vehicle identifiers (alphanumeric).
          required: false
          schema:
            type: array
            description: Comma separated list of vehicle identifiers (alphanumeric).
            items:
              type: string
        - name: groupIds
          in: query
          description: Comma separated list of group ids.
          required: false
          schema:
            type: array
            description: Comma separated list of group ids.
            items:
              type: string
        - name: driverIds
          in: query
          description: Comma separated list of driver identifiers (alphanumeric).
          required: false
          schema:
            type: array
            description: Comma separated list of driver identifiers (alphanumeric).
            items:
              type: string
        - name: fromDateTime
          in: query
          description: Start date and time for the tracking data retrieval
          required: false
          schema:
            type: string
            description: Start date and time for the tracking data retrieval
            format: date-time
        - name: showAllVehicleStatus
          in: query
          description: >-
            Boolean (true/false) to indicate if details of all vehicles should
            be included, irrespective of their status. If not specified,
            defaults to FALSE, so vehicles with a status of SOLD are excluded
            from the response.
          required: false
          schema:
            type: boolean
            description: >-
              Boolean (true/false) to indicate if details of all vehicles should
              be included, irrespective of their status. If not specified,
              defaults to FALSE, so vehicles with a status of SOLD are excluded
              from the response.
      responses:
        '200':
          description: >-
            List of most recent detailed tracking input, where 1 item contains
            combined CurrentPositionResult and Asset data. Data are selected
            from DB based on either vehicleIds or driverIds or groupIds. If none
            of the DB selector fits it returns empty list
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/Fleet'
        '400':
          description: >-
            When multiple filter option are filled in (vehicleIds and groupIds
            OR vehicleIds and driverIds OR driverIds and groupIds).

            When filtering field contains id of resource which is not visible to
            user. Message is: 'fieldName: Invalid value [value] => Resource not
            visible to User'
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/ApiErrorDto'
components:
  schemas:
    Fleet:
      required:
        - equipment
      type: object
      properties:
        equipment:
          type: array
          xml:
            name: Equipment
          items:
            $ref: '#/components/schemas/Equipment'
        version:
          type: integer
          format: int64
          xml:
            attribute: true
        snapshotTime:
          type: string
          format: date-time
          xml:
            attribute: true
      xml:
        name: Fleet
        namespace: http://schemas.aemp.org/fleet
    ApiErrorDto:
      type: object
      properties:
        errorCode:
          type: integer
          format: int32
        errorMessage:
          type: string
        offendingFields:
          type: array
          items:
            type: string
    Equipment:
      required:
        - equipmentHeader
      type: object
      properties:
        equipmentHeader:
          $ref: '#/components/schemas/EquipmentHeader'
        location:
          $ref: '#/components/schemas/Location'
        cumulativeOperatingHours:
          $ref: '#/components/schemas/CumulativeOperatingHours'
        fuelUsed:
          $ref: '#/components/schemas/FuelUsed'
        fuelUsedLast24:
          $ref: '#/components/schemas/FuelUsedLast24'
        distance:
          $ref: '#/components/schemas/Distance'
    EquipmentHeader:
      type: object
      properties:
        unitInstallDateTime:
          type: string
          format: date-time
          xml:
            name: UnitInstallDateTime
        make:
          type: string
          xml:
            name: Make
        model:
          type: string
          xml:
            name: Model
        equipmentID:
          type: string
          xml:
            name: EquipmentID
        serialNumber:
          type: string
          xml:
            name: SerialNumber
    Location:
      required:
        - altitudeUnits
        - latitude
        - longitude
      type: object
      properties:
        latitude:
          type: number
          xml:
            name: Latitude
        longitude:
          type: number
          xml:
            name: Longitude
        altitude:
          $ref: '#/components/schemas/Altitude'
        altitudeUnits:
          type: string
          xml:
            name: AltitudeUnits
          enum:
            - FEET_INCHES
            - METERS
        datetime:
          type: string
          format: date-time
          xml:
            attribute: true
    CumulativeOperatingHours:
      required:
        - hour
      type: object
      properties:
        hour:
          type: object
          properties:
            seconds:
              type: integer
              format: int32
            years:
              type: integer
              format: int32
            months:
              type: integer
              format: int32
            days:
              type: integer
              format: int32
            hours:
              type: integer
              format: int32
            minutes:
              type: integer
              format: int32
            xmlschemaType:
              type: object
              properties:
                namespaceURI:
                  type: string
                localPart:
                  type: string
                prefix:
                  type: string
            sign:
              type: integer
              format: int32
          xml:
            name: Hour
        resetDateTime:
          type: string
          format: date-time
          xml:
            name: ResetDateTime
        datetime:
          type: string
          format: date-time
          xml:
            attribute: true
    FuelUsed:
      required:
        - fuelUnits
      type: object
      properties:
        fuelUnits:
          type: string
          xml:
            name: FuelUnits
          enum:
            - GALLON
            - LITER
        fuelConsumed:
          type: integer
          format: int64
          xml:
            name: FuelConsumed
        resetDateTime:
          type: string
          format: date-time
          xml:
            name: ResetDateTime
        datetime:
          type: string
          format: date-time
          xml:
            attribute: true
    FuelUsedLast24:
      required:
        - fuelUnits
      type: object
      properties:
        fuelUnits:
          type: string
          xml:
            name: FuelUnits
          enum:
            - GALLON
            - LITER
        fuelConsumed:
          type: integer
          format: int64
          xml:
            name: FuelConsumed
        datetime:
          type: string
          format: date-time
          xml:
            attribute: true
    Distance:
      required:
        - odometerUnits
      type: object
      properties:
        odometerUnits:
          type: string
          xml:
            name: OdometerUnits
          enum:
            - MILE
            - KILOMETER
        odometer:
          type: integer
          format: int64
          xml:
            name: Odometer
        resetDateTime:
          type: string
          format: date-time
          xml:
            name: ResetDateTime
        datetime:
          type: string
          format: date-time
          xml:
            attribute: true
    Altitude:
      required:
        - altitudeUnits
      type: object
      properties:
        altitudeUnits:
          type: string
          xml:
            name: AltitudeUnits
          enum:
            - FEET_INCHES
            - METERS
        feet:
          type: integer
          format: int64
          xml:
            name: Feet
        inches:
          type: integer
          format: int64
          xml:
            name: Inches
        meters:
          type: number
          xml:
            name: Meters
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````