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

# Vehicle Speeding Detail

> Returns details for speeding episodes that occurred within the specified period. The end of the speeding episode does not have to be within the specified period. No details are returned for speeding episodes during a private journey.<br/><br/>The value specified for the endDate cannot be before startDate and the date range between startDate and endDate cannot be more than 7 days.<br/><br/>A value for either vehicleId or groupId must be specified.<br/><br/>If there are more than 50 speeding episodes that match the search criteria, then by default only the first 50 speeding episodes are returned. To view details of the other speeding episodes you will need to specify values for pageSize and pageIndex.<br/><br/><b>Asset Day Limit</b>: The asset day limit on this endpoint is 50 asset days. You will receive an HTTP status code of 400 (Bad input parameters) and no details will be returned if you exceed this restriction.



## OpenAPI

````yaml /api-reference/performance.json get /public/v1/customer/{customerId}/speeding/detail/vehicle
openapi: 3.0.1
info:
  title: Performance
  description: >-
    Delivers deeper insights into driver behaviour, fuel efficiency, CO₂ impact
    and safe driving practices.
  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: /driver
    description: Driver Operations
  - name: /driverbehaviourmetrics
    description: Driver Behaviour Metrics
  - name: customers
    description: Customer Behaviour Metrics
  - name: /ecoscore
    description: EcoScore
  - name: /fuel
    description: Fuel
  - name: /idling
    description: Idling
  - name: /speeding
    description: Speeding
  - name: /tokenInformation
    description: Token operations
  - name: /utilisation
    description: Utilisation
  - name: /vehicle
    description: Vehicle management operations
paths:
  /public/v1/customer/{customerId}/speeding/detail/vehicle:
    get:
      tags:
        - /speeding
      summary: Vehicle Speeding Detail
      description: >-
        Returns details for speeding episodes that occurred within the specified
        period. The end of the speeding episode does not have to be within the
        specified period. No details are returned for speeding episodes during a
        private journey.<br/><br/>The value specified for the endDate cannot be
        before startDate and the date range between startDate and endDate cannot
        be more than 7 days.<br/><br/>A value for either vehicleId or groupId
        must be specified.<br/><br/>If there are more than 50 speeding episodes
        that match the search criteria, then by default only the first 50
        speeding episodes are returned. To view details of the other speeding
        episodes you will need to specify values for pageSize and
        pageIndex.<br/><br/><b>Asset Day Limit</b>: The asset day limit on this
        endpoint is 50 asset days. You will receive an HTTP status code of 400
        (Bad input parameters) and no details will be returned if you exceed
        this restriction.
      operationId: getVehicleSpeedingDetails
      parameters:
        - name: customerId
          in: path
          required: true
          schema:
            type: string
        - name: pageIndex
          in: query
          description: >-
            Specifies the pagination page index.<br/>Pages are zero indexed,
            i.e. the first page has an index value of zero.
          required: false
          schema:
            type: integer
            description: >-
              Specifies the pagination page index.<br/>Pages are zero indexed,
              i.e. the first page has an index value of zero.
            format: int32
        - name: pageSize
          in: query
          description: >-
            Specifies the number of items to include on a page.<br/>Must be
            specified if pageIndex has been specified.
          required: false
          schema:
            type: integer
            description: >-
              Specifies the number of items to include on a page.<br/>Must be
              specified if pageIndex has been specified.
            format: int32
        - name: startDate
          in: query
          description: >-
            Start date and time for the search period. Format:
            yyyy-MM-dd'T'HH:mm:ss in UTC. Required.
          required: true
          schema:
            type: string
            description: >-
              Start date and time for the search period. Format:
              yyyy-MM-dd'T'HH:mm:ss in UTC. Required.
            format: date-time
        - name: endDate
          in: query
          description: >-
            End date and time for the search period. Format:
            yyyy-MM-dd'T'HH:mm:ss in UTC. Required and must be within 7 days of
            startDate.
          required: true
          schema:
            type: string
            description: >-
              End date and time for the search period. Format:
              yyyy-MM-dd'T'HH:mm:ss in UTC. Required and must be within 7 days
              of startDate.
            format: date-time
        - name: fromDateTime
          in: query
          description: >-
            From date and time for filtering speeding episodes. Cannot be older
            than 1 hour from execution time. Format: yyyy-MM-dd'T'HH:mm:ss in
            UTC.
          required: false
          schema:
            type: string
            description: >-
              From date and time for filtering speeding episodes. Cannot be
              older than 1 hour from execution time. Format:
              yyyy-MM-dd'T'HH:mm:ss in UTC.
            format: date-time
        - name: percentAboveLimit
          in: query
          description: >-
            Filter for speeding episodes where speed exceeds limit by this
            percentage. Must be >= 0 if specified.
          required: false
          schema:
            type: integer
            description: >-
              Filter for speeding episodes where speed exceeds limit by this
              percentage. Must be >= 0 if specified.
            format: int32
        - name: excludeChildGroups
          in: query
          description: Whether to exclude child groups from the search. Defaults to false.
          required: false
          schema:
            type: boolean
            description: >-
              Whether to exclude child groups from the search. Defaults to
              false.
        - name: vehicleId
          in: query
          description: >-
            Vehicle identifier for searching speeding episodes by specific
            vehicle.
          required: false
          schema:
            type: string
            description: >-
              Vehicle identifier for searching speeding episodes by specific
              vehicle.
        - name: groupId
          in: query
          description: >-
            Group identifier for searching speeding episodes by group. Required
            if not using specific entity ID.
          required: false
          schema:
            type: string
            description: >-
              Group identifier for searching speeding episodes by group.
              Required if not using specific entity ID.
      responses:
        '200':
          description: Speeding episode details successfully returned with pagination
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/WithPaginationResultSpeedingDetailDto'
        '400':
          description: >-
            Bad input parameters - when endDate is before startDate, date range
            exceeds 7 days, asset day limit exceeded, or validation errors
        '404':
          description: No speeding episodes found for the specified criteria
components:
  schemas:
    WithPaginationResultSpeedingDetailDto:
      type: object
      properties:
        totalPages:
          type: integer
          description: Total number of pages based on the pageSize.
          format: int32
        totalCount:
          type: integer
          description: Total number of items that matched the search parameters.
          format: int64
        items:
          type: array
          description: Array of items.
          items:
            $ref: '#/components/schemas/SpeedingDetailDto'
    SpeedingDetailDto:
      type: object
      properties:
        pageIndex:
          type: integer
          description: >-
            Specifies the pagination page index.<br/>Pages are zero indexed,
            i.e. the first page has an index value of zero.
          format: int32
        pageSize:
          type: integer
          description: >-
            Specifies the number of items to include on a page.<br/>Must be
            specified if pageIndex has been specified.
          format: int32
        startTime:
          type: string
          description: >-
            Start date and time of the speeding episode. Format:
            yyyy-MM-dd'T'HH:mm:ss in UTC.
          format: date-time
        maxSpeedTime:
          type: string
          description: >-
            Date and time when maximum speed was reached during the episode.
            Format: yyyy-MM-dd'T'HH:mm:ss in UTC.
          format: date-time
        endTime:
          type: string
          description: >-
            End date and time of the speeding episode. Format:
            yyyy-MM-dd'T'HH:mm:ss in UTC.
          format: date-time
        assetId:
          type: string
          description: >-
            Unique identifier of the vehicle/asset involved in the speeding
            episode.
        driverId:
          type: string
          description: Unique identifier of the driver involved in the speeding episode.
        driverName:
          type: string
          description: Name of the driver involved in the speeding episode.
        assetRegistration:
          type: string
          description: Vehicle registration number.
        assetName:
          type: string
          description: Name or friendly identifier of the vehicle/asset.
        startAddress:
          type: string
          description: Address where the speeding episode started.
        endAddress:
          type: string
          description: Address where the speeding episode ended.
        duration:
          type: integer
          description: Duration of the speeding episode in seconds.
          format: int64
        distanceKms:
          type: number
          description: Distance covered during the speeding episode in kilometers.
          format: double
        groupName:
          type: string
          description: Name of the group the vehicle/asset belongs to.
        averageSpeed:
          type: number
          description: Average speed during the speeding episode in km/h.
          format: float
        maxSpeed:
          type: number
          description: Maximum speed reached during the speeding episode in km/h.
          format: float
        maxPercentageOver:
          type: number
          description: Maximum percentage over the speed limit during the episode.
          format: float
        maxSpeedAddress:
          type: string
          description: Address where the maximum speed was recorded.
        maxSpeedCoordinates:
          $ref: '#/components/schemas/CoordinateDto'
        startCoordinates:
          $ref: '#/components/schemas/CoordinateDto'
        endCoordinates:
          $ref: '#/components/schemas/CoordinateDto'
        speedingPointCount:
          type: integer
          description: Number of speeding data points recorded during the episode.
          format: int32
        assetSpeedLimitKph:
          type: number
          description: Vehicle's speed limit in km/h.
          format: float
        roadSpeedLimitKph:
          type: number
          description: Road speed limit in km/h.
          format: float
        maxSpeedDistanceKm:
          type: number
          description: Distance from start to point of maximum speed in kilometers.
          format: double
        startLocation:
          type: string
          description: Location description where the speeding episode started.
        endLocation:
          type: string
          description: Location description where the speeding episode ended.
        maxSpeedLocation:
          type: string
          description: Location description where maximum speed was recorded.
        startLocationId:
          type: string
          description: Location identifier where the speeding episode started.
        endLocationId:
          type: string
          description: Location identifier where the speeding episode ended.
        maxSpeedLocationId:
          type: string
          description: Location identifier where maximum speed was recorded.
      description: >-
        Details of a speeding episode including timing, location, speed, and
        vehicle/driver information.
    CoordinateDto:
      required:
        - latitude
        - longitude
      type: object
      properties:
        longitude:
          type: number
          description: Longitude coordinate in decimal degrees.
          format: double
        latitude:
          type: number
          description: Latitude coordinate in decimal degrees.
          format: double
      description: Geographic coordinate with latitude and longitude values.
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````