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

> Returns the live position and status for all vehicles in AEMP XML 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/><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 https://api.connectedfleet.michelin.com/vehicle-tracking/api-docs get /public/v1/customer/{customerId}/tracking/live/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.connectedfleet.michelin.com/vehicle-tracking
    description: Product Server
security:
  - bearerAuth: []
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/aemp:
    get:
      tags:
        - /tracking/live
      summary: Live Position AEMP
      description: >-
        Returns the live position and status for all vehicles in AEMP XML
        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/><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: getLiveStatusAemp
      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:
    bearerAuth:
      type: http
      scheme: bearer

````