> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catenatelematics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List HOS Events

> Get a paginated list of Hours of Service (HOS) events information accessible to your organization.

Note: This endpoint uses a smaller maximum page size (500) due to the size of HOS event objects.



## OpenAPI

````yaml https://api.catenatelematics.com/v2/telematics/openapi.json get /v2/telematics/hos-events
openapi: 3.1.0
info:
  title: Telematics Data Service - REST API
  description: Telematics Data Service REST API.
  version: 0.1.0
servers:
  - url: https://api.catenatelematics.com
    description: Catena Telematics API
security: []
tags:
  - name: Fleet Operations & Tracking
    description: >-
      Endpoints for tracking vehicles, trailers, assets, and trip activity —
      including locations, movements, and operational telemetry. Useful for
      monitoring utilization and real-time operational status.
  - name: Safety & Driver Behavior
    description: >-
      Endpoints that provide safety-related insights such as harsh braking,
      speeding, and other driver behavior events. Supports risk analysis and
      safety program automation.
  - name: Compliance & Regulation
    description: >-
      Endpoints covering regulated requirements including DVIR inspections,
      Hours of Service (HOS), violations, and IFTA fuel tax reporting. Helps
      organizations meet DOT/FMCSA and interstate regulatory obligations.
  - name: Maintenance & Vehicle Health
    description: >-
      Endpoints providing data for vehicle condition monitoring and maintenance
      workflows, such as DVIR defects and diagnostic sensor events. Enables
      early issue detection and reduced downtime.
  - name: Drivers & Users
    description: >-
      Endpoints related to driver and user identities, assignments, and
      operational context. Supports linking operational and safety data to
      specific individuals.
  - name: Reference Data (Supporting Tables)
    description: >-
      Lookup tables and enumerations that supply standardized codes, metadata,
      and classifications used across the API.
  - name: Analytics (deprecated)
    description: >-
      Endpoints providing analytical insights and aggregated data for vehicles,
      fleets, drivers, and trailers.
paths:
  /v2/telematics/hos-events:
    get:
      tags:
        - Compliance & Regulation
      summary: List HOS Events
      description: >-
        Get a paginated list of Hours of Service (HOS) events information
        accessible to your organization.


        Note: This endpoint uses a smaller maximum page size (500) due to the
        size of HOS event objects.
      operationId: list_hos_events
      parameters:
        - name: fleet_ids
          in: query
          required: false
          schema:
            anyOf:
              - type: array
                items:
                  type: string
                  format: uuid
                maxItems: 100
              - type: 'null'
            description: >-
              Limit results to specific fleets using Catena's fleet IDs. *For
              your own fleet identifiers, use `fleet_refs` instead* To specify
              multiple values, repeat the parameter for each value (e.g.,
              `?fleet_ids=id1&fleet_ids=id2`).
            title: Fleet Ids
          description: >-
            Limit results to specific fleets using Catena's fleet IDs. *For your
            own fleet identifiers, use `fleet_refs` instead* To specify multiple
            values, repeat the parameter for each value (e.g.,
            `?fleet_ids=id1&fleet_ids=id2`).
        - name: fleet_refs
          in: query
          required: false
          schema:
            anyOf:
              - type: array
                items:
                  type: string
                maxItems: 100
              - type: 'null'
            description: >-
              Limit results to specific fleets using your organization's fleet
              reference identifiers. To specify multiple values, repeat the
              parameter for each value (e.g.,
              `?fleet_refs=ref1&fleet_refs=ref2`).
            title: Fleet Refs
          description: >-
            Limit results to specific fleets using your organization's fleet
            reference identifiers. To specify multiple values, repeat the
            parameter for each value (e.g., `?fleet_refs=ref1&fleet_refs=ref2`).
        - name: connection_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            description: >-
              Limit results to a specific provider connection. This is the UUID
              assigned by Catena when your fleet connects to a TSP.
            title: Connection Id
          description: >-
            Limit results to a specific provider connection. This is the UUID
            assigned by Catena when your fleet connects to a TSP.
        - name: from_datetime
          in: query
          required: false
          schema:
            type: string
            format: date-time
            description: >-
              Return only records that occurred on or after this date and time.
              **Format:** ISO 8601 (UTC) **Applies filter:** `occurred_at >=
              from_datetime` **Default value:** `now() - 1 day` **Restriction:**
              `to_datetime - from_datetime` cannot exceed 45 days
            examples:
              - '2026-06-25T15:05:51.529365Z'
            title: From Datetime
          description: >-
            Return only records that occurred on or after this date and time.
            **Format:** ISO 8601 (UTC) **Applies filter:** `occurred_at >=
            from_datetime` **Default value:** `now() - 1 day` **Restriction:**
            `to_datetime - from_datetime` cannot exceed 45 days
        - name: to_datetime
          in: query
          required: false
          schema:
            type: string
            format: date-time
            description: >-
              Return only records that occurred before this date and time.
              **Format:** ISO 8601 (UTC) **Applies filter:** `occurred_at <
              to_datetime` **Default value:** `now()` **Restriction:**
              `to_datetime - from_datetime` cannot exceed 45 days
            examples:
              - '2026-06-26T15:05:51.529502Z'
            title: To Datetime
          description: >-
            Return only records that occurred before this date and time.
            **Format:** ISO 8601 (UTC) **Applies filter:** `occurred_at <
            to_datetime` **Default value:** `now()` **Restriction:**
            `to_datetime - from_datetime` cannot exceed 45 days
        - name: active_from_datetime
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            description: >-
              Return only records that were still active at or after this date
              and time. **Format:** ISO 8601 (UTC) **Applies filter:** `ended_at
              >= active_from_datetime`
            examples:
              - '2026-06-25T15:05:51.529710Z'
            title: Active From Datetime
          description: >-
            Return only records that were still active at or after this date and
            time. **Format:** ISO 8601 (UTC) **Applies filter:** `ended_at >=
            active_from_datetime`
        - name: active_to_datetime
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            description: >-
              Return only records that started before this date and time.
              **Format:** ISO 8601 (UTC) **Applies filter:** `started_at <
              active_to_datetime`
            examples:
              - '2026-06-26T15:05:51.529769Z'
            title: Active To Datetime
          description: >-
            Return only records that started before this date and time.
            **Format:** ISO 8601 (UTC) **Applies filter:** `started_at <
            active_to_datetime`
        - name: include_source_data
          in: query
          required: false
          schema:
            type: boolean
            description: >-
              Include the raw data from the telematics provider. *Useful for
              auditing or accessing fields not normalized by Catena*
            default: false
            title: Include Source Data
          description: >-
            Include the raw data from the telematics provider. *Useful for
            auditing or accessing fields not normalized by Catena*
        - name: driver_ids
          in: query
          required: false
          schema:
            anyOf:
              - type: array
                items:
                  type: string
                  format: uuid
                maxItems: 100
              - type: 'null'
            description: >-
              Limit results to specific drivers. **Maximum:** 100 IDs To specify
              multiple values, repeat the parameter for each value (e.g.,
              `?driver_ids=id1&driver_ids=id2`).
            title: Driver Ids
          description: >-
            Limit results to specific drivers. **Maximum:** 100 IDs To specify
            multiple values, repeat the parameter for each value (e.g.,
            `?driver_ids=id1&driver_ids=id2`).
        - name: vehicle_ids
          in: query
          required: false
          schema:
            anyOf:
              - type: array
                items:
                  type: string
                  format: uuid
                maxItems: 100
              - type: 'null'
            description: >-
              Limit results to specific vehicles. **Maximum:** 100 IDs To
              specify multiple values, repeat the parameter for each value
              (e.g., `?vehicle_ids=id1&vehicle_ids=id2`).
            title: Vehicle Ids
          description: >-
            Limit results to specific vehicles. **Maximum:** 100 IDs To specify
            multiple values, repeat the parameter for each value (e.g.,
            `?vehicle_ids=id1&vehicle_ids=id2`).
        - name: event_type_codes
          in: query
          required: false
          schema:
            anyOf:
              - type: array
                items:
                  $ref: '#/components/schemas/HosEventTypeCodeEnum'
                maxItems: 5
              - type: 'null'
            description: >-
              Limit results to specific HOS event type codes. **Maximum:** 5
              codes To specify multiple values, repeat the parameter for each
              value (e.g., `?event_type_codes=code1&event_type_codes=code2`).
            title: Event Type Codes
          description: >-
            Limit results to specific HOS event type codes. **Maximum:** 5 codes
            To specify multiple values, repeat the parameter for each value
            (e.g., `?event_type_codes=code1&event_type_codes=code2`).
        - name: cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Cursor for the next page
            title: Cursor
          description: Cursor for the next page
        - name: size
          in: query
          required: false
          schema:
            type: integer
            maximum: 500
            minimum: 1
            description: Page size
            default: 300
            title: Size
          description: Page size
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/_LargeObjectCursorPage_HosEventRead_'
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequest'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Unauthorized'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Forbidden'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFound'
          description: Not Found
        '405':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MethodNotAllowed'
          description: Method Not Allowed
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Conflict'
          description: Conflict
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnprocessableEntity'
          description: Unprocessable Entity
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TooManyRequests'
          description: Too Many Requests
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
          description: Internal Server Error
        '501':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotImplementedResponse'
          description: Not Implemented
      security:
        - Bearer:
            - telematics:read
components:
  schemas:
    HosEventTypeCodeEnum:
      type: string
      enum:
        - '1'
        - '2'
        - '3'
        - '4'
        - '5'
        - '6'
      title: HosEventTypeCodeEnum
      description: Enum for HOS event type codes
    _LargeObjectCursorPage_HosEventRead_:
      properties:
        items:
          items:
            $ref: '#/components/schemas/HosEventRead'
          type: array
          title: Items
        total:
          type: integer
          minimum: 0
          title: Total
        current_page:
          anyOf:
            - type: string
            - type: 'null'
          title: Current Page
          description: Cursor to refetch the current page
        current_page_backwards:
          anyOf:
            - type: string
            - type: 'null'
          title: Current Page Backwards
          description: Cursor to refetch the current page starting from the last item
        previous_page:
          anyOf:
            - type: string
            - type: 'null'
          title: Previous Page
          description: Cursor for the previous page
        next_page:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Page
          description: Cursor for the next page
      type: object
      required:
        - items
        - total
      title: _LargeObjectCursorPage[HosEventRead]
    BadRequest:
      properties:
        code:
          type: integer
          title: Code
          default: 400
        message:
          type: string
          title: Message
          default: Bad Request
        detail:
          anyOf:
            - type: string
            - type: 'null'
          title: Detail
      type: object
      title: BadRequest
    Unauthorized:
      properties:
        code:
          type: integer
          title: Code
          default: 401
        message:
          type: string
          title: Message
          default: Unauthorized
        detail:
          anyOf:
            - type: string
            - type: 'null'
          title: Detail
      type: object
      title: Unauthorized
    Forbidden:
      properties:
        code:
          type: integer
          title: Code
          default: 403
        message:
          type: string
          title: Message
          default: Forbidden
        detail:
          anyOf:
            - type: string
            - type: 'null'
          title: Detail
      type: object
      title: Forbidden
    NotFound:
      properties:
        code:
          type: integer
          title: Code
          default: 404
        message:
          type: string
          title: Message
          default: Not Found
        detail:
          anyOf:
            - type: string
            - type: 'null'
          title: Detail
      type: object
      title: NotFound
    MethodNotAllowed:
      properties:
        code:
          type: integer
          title: Code
          default: 405
        message:
          type: string
          title: Message
          default: Method Not Allowed
        detail:
          anyOf:
            - type: string
            - type: 'null'
          title: Detail
      type: object
      title: MethodNotAllowed
    Conflict:
      properties:
        code:
          type: integer
          title: Code
          default: 409
        message:
          type: string
          title: Message
          default: Conflict
        detail:
          anyOf:
            - type: string
            - type: 'null'
          title: Detail
      type: object
      title: Conflict
    UnprocessableEntity:
      properties:
        code:
          type: integer
          title: Code
          default: 422
        message:
          type: string
          title: Message
          default: Invalid Request Body
        detail:
          anyOf:
            - items:
                $ref: '#/components/schemas/ValidationErrorDetail'
              type: array
            - type: 'null'
          title: Detail
      type: object
      title: UnprocessableEntity
    TooManyRequests:
      properties:
        code:
          type: integer
          title: Code
          default: 429
        message:
          type: string
          title: Message
          default: Too Many Requests
        detail:
          anyOf:
            - $ref: '#/components/schemas/RetryAfterDetail'
            - type: 'null'
      type: object
      title: TooManyRequests
    InternalServerError:
      properties:
        message:
          type: string
          title: Message
          default: Internal Server Error
      type: object
      title: InternalServerError
    NotImplementedResponse:
      properties:
        code:
          type: integer
          title: Code
          default: 501
        message:
          type: string
          title: Message
          default: Not Implemented
        detail:
          anyOf:
            - type: string
            - type: 'null'
          title: Detail
      type: object
      title: NotImplementedResponse
    HosEventRead:
      properties:
        fleet_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Fleet Id
          description: Internal fleet identifier.
        fleet_ref:
          anyOf:
            - type: string
            - type: 'null'
          title: Fleet Ref
          description: External fleet reference in the partner system.
        id:
          type: string
          format: uuid
          title: Id
          description: Unique identifier of the record at Catena Telematics.
        created_at:
          type: string
          format: date-time
          title: Created At
          description: >-
            Immutable: The datetime the record was ingested into Catena
            Telematics.
        updated_at:
          type: string
          format: date-time
          title: Updated At
          description: The dateime the record was last modified in Catena Telematics.
        deleted_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Deleted At
          description: >-
            The datetime the record was logically deleted from Catena
            Telematics.
        connection_id:
          type: string
          format: uuid
          title: Connection Id
          description: >-
            Unique identifier of the connection at Catena Telematics through
            which this record was ingested. A connection represents a Fleet/TSP
            pairing.
        tsp_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Tsp Id
          description: >-
            Unique identifier of the TSP at Catena Telematics from which this
            record was ingested.
        tsp_slug:
          anyOf:
            - type: string
            - type: 'null'
          title: Tsp Slug
          description: >-
            Human readable slug of the TSP at Catena Telematics from which this
            record was ingested.
        source_name:
          $ref: '#/components/schemas/TspEnum'
          description: >-
            The underlying telematics platform that provided this data (e.g.,
            `samsara`, `motive`, `hos247`). Note: Some platforms like `hos247`
            offer white-labeling, so multiple TSPs may share the same
            source_name — use `tsp_id` or `tsp_slug` to identify the specific
            ELD provider.
        source_data:
          additionalProperties: true
          type: object
          title: Source Data
          description: >-
            Raw source payload as ingested from the TSP. **Note: use it for
            audit/debugging.**
        source_id:
          type: string
          title: Source Id
          description: >-
            Unique identifier of the record in the TSP. **Note: we generate a
            unique composite key based on available fields if the TSP does not
            provide an unique ID.**
        source_data_hash:
          type: string
          maxLength: 64
          title: Source Data Hash
          description: >-
            SHA-256 hash of the source data payload. **Note: we use it
            internally for idempotence and deduplication.**
        occurred_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Occurred At
          description: >-
            Datetime of when the underlying event/observation occurred, as
            reported by the TSP, or the moment it was ingested by us if not
            available in the source data.
        execution_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Execution Id
          description: >-
            Unique identifier for the execution that ingested this record into
            Catena Telematics. **Note: useful for tracing.**
        schedule_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Schedule Id
          description: >-
            Unique identifier for schedule that triggered this record's
            execution. **Note: useful for tracing.**
        extras:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Extras
          description: >-
            Additional data available in the TSP (e.g., we may have
            `external_id`, `provider_resource_id`, etc. — this field captures
            all those extra attributes in a flexible way).
        driver_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Driver Id
          description: Internal driver identifier (Catena FK).
        vehicle_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Vehicle Id
          description: Internal vehicle identifier (Catena FK).
        co_driver_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Co Driver Id
          description: Internal co-driver identifier (Catena FK), if present.
        additional_driver_ids:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Additional Driver Ids
          description: Array/object of additional internal driver IDs beyond co-driver
        started_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Started At
          description: >-
            Timestamp when the event interval begins (UTC). For point events,
            set equal to ended_at.
        ended_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Ended At
          description: >-
            Timestamp when the event interval ends (UTC). For point events, may
            equal started_at.
        driver_last_edit_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Driver Last Edit At
          description: >-
            Timestamp of the driver's last edit to this record as reported by
            the TSP (UTC).
        driver_certified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Driver Certified At
          description: Timestamp when the driver certified/attested to this record (UTC).
        hos_ruleset_code:
          anyOf:
            - $ref: '#/components/schemas/HosRulesetCodeEnum'
            - type: 'null'
          description: Driver's HOS cycle Ruleset code (normalized).
        time_zone_code:
          anyOf:
            - $ref: '#/components/schemas/TimezoneCodeEnum'
            - type: 'null'
          description: >-
            IANA time zone ID used by the vendor for this log (e.g.,
            America/Chicago).
        annotations:
          anyOf:
            - $ref: '#/components/schemas/HosEventAnnotation'
            - type: 'null'
          description: Event remarks or annotations.
        duty_status_code:
          anyOf:
            - $ref: '#/components/schemas/DutyStatusCodeEnum'
            - type: 'null'
          description: >-
            Canonical duty status: OFF (off-duty), SB (sleeper berth), D
            (driving), ON (on-duty), PC (personal conveyance), YM (yard move),
            INT (interruption), WT (waiting).
        event_type_code:
          anyOf:
            - $ref: '#/components/schemas/HosEventTypeCodeEnum'
            - type: 'null'
          description: Vendor-specific event type label.
        event_code:
          anyOf:
            - $ref: '#/components/schemas/HosEventCodeEnum'
            - type: 'null'
          description: Vendor compliance code (e.g., Geotab Table 6 EventCode).
        log_state_code:
          anyOf:
            - $ref: '#/components/schemas/HosRecordStatusCodeEnum'
            - type: 'null'
          description: Vendor log state (e.g., ACTIVE, INACTIVE, CHANGED).
        log_origin_code:
          anyOf:
            - $ref: '#/components/schemas/HosRecordOriginCodeEnum'
            - type: 'null'
          description: Origin of the log entry (e.g., AUTOMATIC, MANUAL).
        deferral_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Deferral Status
          description: Canadian deferral status, if applicable (e.g., DAY1, DAY2).
        deferral_minutes:
          anyOf:
            - type: integer
            - type: 'null'
          title: Deferral Minutes
          description: Minutes deferred under Canadian deferral rules, if applicable.
        eld_malfunction_code:
          anyOf:
            - $ref: '#/components/schemas/HosMalfunctionCodeEnum'
            - type: 'null'
          description: Vendor-reported ELD malfunction code related to HOS
        is_excluded:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Excluded
          description: >-
            Indicates whether this event should be excluded from compliance
            calculations.
        is_transitioning:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Transitioning
          description: >-
            Transitional state flag for in-progress vendor updates (default
            false).
          default: false
        record_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Record Status
          description: Vendor record status (e.g., active, inactive, changed).
          default: active
        region_code:
          anyOf:
            - $ref: '#/components/schemas/HosRegionCodeEnum'
            - type: 'null'
          description: Normalized state/province code (e.g., US-CA, CA-ON).
        location_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Location Name
          description: Human-readable location string (e.g., 'Denver, CO').
        location:
          anyOf:
            - $ref: '#/components/schemas/Point'
            - additionalProperties: true
              type: object
            - {}
            - type: 'null'
          title: Location
          description: >-
            Geographic point of the event (lat/lng, SRID 4326; GeoJSON Point or
            WKB/EWKB).
        inferred_address:
          anyOf:
            - $ref: '#/components/schemas/InferredAddress'
            - type: 'null'
          description: Inferred city level address from latitude and longitude.
        h3_index_11:
          anyOf:
            - type: integer
            - type: 'null'
          title: H3 Index 11
          description: H3 geospatial index (resolution 11) derived from the location.
        odometer:
          anyOf:
            - type: number
            - type: 'null'
          title: Odometer
          description: Odometer reading at the event (meters).
        engine_hours:
          anyOf:
            - type: number
            - type: 'null'
          title: Engine Hours
          description: Engine hours at the event (as reported by the vendor).
        sequence:
          anyOf:
            - type: string
            - type: 'null'
          title: Sequence
          description: >-
            Vendor sequencing token for ETL ordering/debugging (not end-user
            facing).
        version:
          anyOf:
            - type: string
            - type: 'null'
          title: Version
          description: >-
            Vendor payload/version tag for ETL idempotency/debugging (not
            end-user facing).
      type: object
      required:
        - fleet_id
        - id
        - created_at
        - updated_at
        - connection_id
        - source_name
        - source_id
        - source_data_hash
      title: HosEventRead
      description: HosEvent model for API responses
    ValidationErrorDetail:
      properties:
        path:
          type: string
          title: Path
        input:
          type: string
          title: Input
        message:
          type: string
          title: Message
        error_type:
          type: string
          title: Error Type
      type: object
      required:
        - path
        - input
        - message
        - error_type
      title: ValidationErrorDetail
    RetryAfterDetail:
      properties:
        retry_after_seconds:
          type: integer
          title: Retry After Seconds
        message:
          type: string
          title: Message
      type: object
      required:
        - retry_after_seconds
        - message
      title: RetryAfterDetail
    TspEnum:
      type: string
      enum:
        - ada
        - ai_eld
        - air_eld
        - alfa_eld
        - alpha_eld
        - als
        - anytrek_pro
        - anytrek_classic
        - apex_eld
        - apollo
        - apollocloud
        - ascend
        - att
        - awaregps
        - azuga
        - bigroad
        - bluehorse_eld
        - blueinktech
        - bouncie
        - budgetgps
        - catena_simulator
        - captain_eld
        - carrier_lynx
        - club_eld
        - counting_trucks_eld
        - cyntrx
        - digital_eld
        - dragon_eld
        - drive_hos
        - drive_hos_v2
        - driver_tech
        - dsg_elogs
        - dynamic_eld
        - eighteighteight_eld
        - eld_88
        - eld_books
        - eld_mandate
        - eld_mandate_prime
        - eroad
        - eva_eld
        - evo_eld
        - expressway_eld
        - extreme_eld
        - ezlogz
        - ez_lynk
        - factor_eld
        - firstgate
        - fleetcomplete
        - fleetcompletehub
        - fleethunt
        - fleetpulse
        - fleetsharp
        - fleetup
        - fm
        - forwardthinking
        - forza_eld
        - geotab
        - gpsinsight
        - gpstab
        - gpstrackit
        - grand_eld
        - greenlight
        - groundhog
        - hcss
        - hos247
        - hutch
        - intellishift
        - ironman_eld
        - isaac
        - jjkeller
        - kinexaiot
        - knight_eld
        - konexial
        - lioneight
        - linxup
        - loop_eld
        - lucid_eld
        - luna_eld
        - lytx
        - lytxv3
        - mapon
        - matrack
        - maven
        - mdm_eld
        - mobilefleet
        - moonlight_eld
        - motion_eld
        - motive
        - my_drivebook
        - my_logs_eld
        - nero
        - netradyne
        - new_eld_world
        - nextgen_eld
        - nextraq
        - omnitracs
        - onestep
        - ontime_eld
        - optima
        - orbcomm
        - orient_eld
        - panda_eld
        - payd
        - peak_eld
        - peoplenet
        - phillips_connect
        - phoenix
        - pop_eld
        - prologs
        - proride_eld
        - qualitylogs_eld
        - randmcnally
        - rastrac
        - raven
        - redfox
        - regulog_eld
        - ridehub
        - roadeazy
        - rock_eld
        - rollingtrans
        - routemate
        - royal_eld
        - safelane
        - samsara
        - selectivedrive
        - simba_eld
        - skybitz
        - smart_elds
        - sparkle_eld
        - spireon
        - sun_eld
        - surfsight
        - swift
        - switchboard
        - synergy_eld
        - teletracnavman
        - teletracnavman_director
        - telogis
        - tenna
        - thermo_king
        - think
        - tive
        - topcompliance_eld
        - traccar
        - trackease_eld
        - trackpro
        - traclog
        - transflo
        - trimble
        - truckford
        - truckspy
        - truckx
        - trueroad_eld
        - tt
        - txt_eld
        - us_fast_eld
        - verizon_connect
        - vista_eld
        - vistracks
        - vlog_eld
        - vulcansols_eld
        - wialon
        - webfleet
        - xplore_eld
        - zigzag_eld
        - zms_eld
        - zonar
        - zubie
      title: TspEnum
      description: Enum for TSPs
    HosRulesetCodeEnum:
      type: string
      enum:
        - US_INT_PROP_60_7
        - US_INT_PROP_60_7_BIG
        - US_INT_PROP_60_7_BIG_SLP
        - US_INT_PROP_60_7_NORST
        - US_INT_PROP_60_7_NORST_SLP
        - US_INT_PROP_60_7_NOBRK
        - US_INT_PROP_60_7_NOBRK_BIG
        - US_INT_PROP_60_7_NOBRK_BIG_SLP
        - US_INT_PROP_60_7_NOBRK_SLP
        - US_INT_PROP_60_7_SH
        - US_INT_PROP_60_7_SH_NORST
        - US_INT_PROP_70_8
        - US_INT_PROP_70_8_BIG
        - US_INT_PROP_70_8_BIG_SLP
        - US_INT_PROP_70_8_NORST
        - US_INT_PROP_70_8_NORST_SLP
        - US_INT_PROP_70_8_NOBRK
        - US_INT_PROP_70_8_NOBRK_BIG
        - US_INT_PROP_70_8_NOBRK_BIG_SLP
        - US_INT_PROP_70_8_NOBRK_SLP
        - US_INT_PROP_70_8_SH
        - US_INT_PROP_70_8_SH_14H
        - US_INT_PROP_70_8_SH_NORST
        - US_INT_PROP_SH_14H
        - US_INT_PAX_60_7
        - US_INT_PAX_60_7_SH
        - US_INT_PAX_70_8
        - US_INT_PAX_70_8_SH
        - US_INT_SALESP
        - US_INT_SALESP_NCDL_SH
        - US_INT_OILTR_60_7
        - US_INT_OILTR_70_8
        - US_INT_OILWL_60_7
        - US_INT_OILWL_70_8
        - US_INT_RAIL_EX
        - US_INT_PROP_SLPVAR
        - US_INT_PROP_60_7_SLPVAR
        - US_INT_PROP_70_8_SLPVAR
        - US_INT_CARRIER_EX
        - US_INT_NOHOS_7
        - US_INT_NOHOS_8
        - US_TX_INTRA_PROP_70_7
        - US_TX_INTRA_SH_70_7
        - US_TX_INTRA_SH_70_8
        - US_CA_INTRA_PROP_80_8
        - US_CA_INTRA_PAX_80_8
        - US_CA_INTRA_FARM_112_8
        - US_CA_INTRA_FARM_BRK
        - US_CA_INTRA_FLAM_80_8
        - US_CA_INTRA_FLAM_BRK
        - US_CA_INTRA_SCH_80_8
        - US_CA_INTRA_SCH_BRK
        - US_AK_INTRA_PROP_70_7
        - US_AK_INTRA_PROP_80_8
        - US_AK_INTRA_PAX_70_7
        - US_AK_INTRA_PAX_80_8
        - US_AK_INTRA_PROP_70_7_SLP
        - US_AK_INTRA_PROP_80_8_SLP
        - US_FL_INTRA_PROP_70_7
        - US_FL_INTRA_PROP_80_8
        - US_FL_INTRA_SH_70_7
        - US_FL_INTRA_SH_80_8
        - US_OR_INTRA_PROP_70_7
        - US_OR_INTRA_PROP_80_8
        - US_MD_INTRA_SH_70_7
        - US_MD_INTRA_SH_80_8
        - US_NE_INTRA_PROP_70_7
        - US_NE_INTRA_PROP_80_8
        - US_NC_INTRA_PROP_70_7
        - US_NC_INTRA_PROP_80_8
        - US_ND_INTRA_PROP_70_7
        - US_ND_INTRA_SH_70_7
        - US_SC_INTRA_PROP_70_7
        - US_SC_INTRA_PROP_80_8
        - US_WA_INTRA_PROP_70_7
        - US_WA_INTRA_PROP_80_8
        - US_WI_INTRA_PROP_70_7
        - US_WI_INTRA_PROP_80_8
        - CA_FED_C1_70_7
        - CA_FED_C2_120_14
        - CA_FED_C1_TEAM
        - CA_FED_C2_TEAM
        - CA_FED_NOHOS
        - CA_N60_C1_80_7
        - CA_N60_C2_120_14
        - CA_N60_C1_TEAM
        - CA_N60_C2_TEAM
        - CA_N60_NOHOS
        - CA_N60_OIL
        - CA_N60_OIL_TEAM
        - CA_AB_PROV_PROP_70_7
        - CA_SK_PROV_PROP_70_7
        - CA_SK_PROV_FERT_EX
        - CA_BC_PROV_LOG
        - CA_S60_OIL
        - CA_OIL_TEAM
        - US_INT_OILTR_60_7_BIG
        - US_INT_OILTR_60_7_BIG_SLP
        - US_INT_OILTR_60_7_SLP
        - US_INT_OILTR_70_8_BIG
        - US_INT_OILTR_70_8_BIG_SLP
        - US_INT_OILTR_70_8_SLP
        - US_CA_INTRA_OILTR_80_8
        - US_CA_INTRA_OILTR_PROP
        - US_INT_OILTR_60_7_NOBRK
        - US_INT_OILTR_60_7_NOBRK_BIG
        - US_INT_OILTR_60_7_NOBRK_BIG_SLP
        - US_INT_OILTR_60_7_NOBRK_SLP
        - US_INT_OILTR_70_8_NOBRK
        - US_INT_OILTR_70_8_NOBRK_BIG
        - US_INT_OILTR_70_8_NOBRK_BIG_SLP
        - US_INT_OILTR_70_8_NOBRK_SLP
        - US_INT_OILTR_SH_12H
        - US_INT_OILTR_SH_14H
        - US_INT_OILTR_70_8_SH_12H
        - US_INT_OILTR_70_8_SH_14H
        - US_TX_INTRA_OILTR_70_7
        - US_INT_OILWL_60_7_BIG
        - US_INT_OILWL_60_7_BIG_SLP
        - US_INT_OILWL_60_7_SLP
        - US_INT_OILWL_70_8_BIG
        - US_INT_OILWL_70_8_BIG_SLP
        - US_INT_OILWL_70_8_SLP
        - US_CA_INTRA_OILWL_80_8
        - US_CA_INTRA_OILWL_PROP
        - US_INT_OILWL_60_7_NOBRK
        - US_INT_OILWL_60_7_NOBRK_BIG
        - US_INT_OILWL_60_7_NOBRK_BIG_SLP
        - US_INT_OILWL_60_7_NOBRK_SLP
        - US_INT_OILWL_70_8_NOBRK
        - US_INT_OILWL_70_8_NOBRK_BIG
        - US_INT_OILWL_70_8_NOBRK_BIG_SLP
        - US_INT_OILWL_70_8_NOBRK_SLP
        - US_TX_INTRA_OILWL_70_7
      title: HosRulesetCodeEnum
      description: Enum for HOS ruleset codes
    TimezoneCodeEnum:
      type: string
      enum:
        - UTC
        - Pacific/Honolulu
        - America/Adak
        - America/Anchorage
        - America/Juneau
        - America/Metlakatla
        - America/Nome
        - America/Sitka
        - America/Yakutat
        - America/Los_Angeles
        - America/Vancouver
        - America/Boise
        - America/Cambridge_Bay
        - America/Creston
        - America/Dawson
        - America/Dawson_Creek
        - America/Denver
        - America/Edmonton
        - America/Fort_Nelson
        - America/Inuvik
        - America/Phoenix
        - America/Whitehorse
        - America/Yellowknife
        - America/Chicago
        - America/Menominee
        - America/North_Dakota/Beulah
        - America/North_Dakota/Center
        - America/North_Dakota/New_Salem
        - America/Rainy_River
        - America/Rankin_Inlet
        - America/Regina
        - America/Resolute
        - America/Swift_Current
        - America/Winnipeg
        - America/Indiana/Knox
        - America/Indiana/Tell_City
        - America/Detroit
        - America/Iqaluit
        - America/Kentucky/Louisville
        - America/Kentucky/Monticello
        - America/New_York
        - America/Nipigon
        - America/Pangnirtung
        - America/Thunder_Bay
        - America/Toronto
        - America/Indiana/Indianapolis
        - America/Indiana/Marengo
        - America/Indiana/Petersburg
        - America/Indiana/Vevay
        - America/Indiana/Vincennes
        - America/Indiana/Winamac
        - America/Atikokan
        - America/Blanc-Sablon
        - America/Glace_Bay
        - America/Goose_Bay
        - America/Halifax
        - America/Moncton
        - America/St_Johns
        - America/Mexico_City
        - America/Cancun
        - America/Merida
        - America/Monterrey
        - America/Mazatlan
        - America/Chihuahua
        - America/Hermosillo
        - America/Tijuana
        - America/Matamoros
        - America/Ojinaga
        - America/Ciudad_Juarez
        - America/Guatemala
        - America/Belize
        - America/Tegucigalpa
        - America/Managua
        - America/Costa_Rica
        - America/Panama
        - America/Bogota
        - America/Lima
        - America/Santiago
        - America/Argentina/Buenos_Aires
        - America/Sao_Paulo
        - America/Montevideo
        - America/Puerto_Rico
        - Europe/London
        - Europe/Dublin
        - Europe/Lisbon
        - Europe/Madrid
        - Europe/Paris
        - Europe/Brussels
        - Europe/Amsterdam
        - Europe/Luxembourg
        - Europe/Berlin
        - Europe/Zurich
        - Europe/Vienna
        - Europe/Rome
        - Europe/Copenhagen
        - Europe/Stockholm
        - Europe/Oslo
        - Europe/Prague
        - Europe/Budapest
        - Europe/Warsaw
        - Europe/Helsinki
        - Europe/Tallinn
        - Europe/Riga
        - Europe/Vilnius
        - Europe/Belgrade
        - Europe/Tirane
        - Europe/Sofia
        - Europe/Athens
        - Europe/Bucharest
        - Europe/Kyiv
        - Europe/Chisinau
        - Europe/Istanbul
        - Europe/Kaliningrad
        - Europe/Moscow
        - Europe/Samara
        - Africa/Casablanca
        - Africa/Algiers
        - Africa/Tunis
        - Africa/Cairo
        - Africa/Tripoli
        - Africa/Lagos
        - Africa/Accra
        - Africa/Dakar
        - Africa/Abidjan
        - Africa/Nairobi
        - Africa/Dar_es_Salaam
        - Africa/Kampala
        - Africa/Johannesburg
        - Africa/Maputo
        - Africa/Windhoek
        - Asia/Dubai
        - Asia/Riyadh
        - Asia/Qatar
        - Asia/Kuwait
        - Asia/Bahrain
        - Asia/Muscat
        - Asia/Baghdad
        - Asia/Amman
        - Asia/Beirut
        - Asia/Jerusalem
        - Asia/Baku
        - Asia/Tbilisi
        - Asia/Yerevan
        - Asia/Almaty
        - Asia/Tashkent
        - Asia/Karachi
        - Asia/Kolkata
        - Asia/Dhaka
        - Asia/Colombo
        - Asia/Kathmandu
        - Asia/Bangkok
        - Asia/Ho_Chi_Minh
        - Asia/Singapore
        - Asia/Kuala_Lumpur
        - Asia/Jakarta
        - Asia/Manila
        - Asia/Shanghai
        - Asia/Hong_Kong
        - Asia/Taipei
        - Asia/Seoul
        - Asia/Tokyo
        - Australia/Sydney
        - Australia/Melbourne
        - Australia/Brisbane
        - Australia/Adelaide
        - Australia/Perth
        - Australia/Darwin
        - Australia/Hobart
        - Pacific/Auckland
      title: TimezoneCodeEnum
      description: Enum for timezone reference codes
    HosEventAnnotation:
      properties:
        created_at:
          type: string
          format: date-time
          title: Created At
          description: Timestamp when the annotation was created.
        remarks:
          type: string
          title: Remarks
          description: Free-text remarks or notes for the HOS event.
      type: object
      required:
        - remarks
      title: HosEventAnnotation
      description: >-
        Annotations or remarks added to HOS events, typically by drivers or
        fleet managers.
    DutyStatusCodeEnum:
      type: string
      enum:
        - 'OFF'
        - SB
        - D
        - 'ON'
        - PC
        - YM
        - INT
        - WT
      title: DutyStatusCodeEnum
      description: Enum for duty status codes
    HosEventCodeEnum:
      type: string
      enum:
        - 'OFF'
        - SB
        - DRIVING
        - 'ON'
        - INT_CONV
        - INT_REDUCED
        - PC
        - YM
        - PCYM_CLEAR
        - CERT1
        - CERT2
        - CERT3
        - CERT4
        - CERT5
        - CERT6
        - CERT7
        - CERT8
        - CERT9
        - LOGIN
        - LOGOUT
        - ENGINE_UP
        - ENGINE_UP_REDUCED
        - ENGINE_DOWN
        - ENGINE_DOWN_REDUCED
        - MALF_LOG
        - MALF_CLEAR
        - DIAG_LOG
        - DIAG_CLEAR
      title: HosEventCodeEnum
      description: Enum for HOS event codes
    HosRecordStatusCodeEnum:
      type: string
      enum:
        - ACTIVE
        - INACTIVE_CHANGED
        - INACTIVE_REQUESTED
        - INACTIVE_REJECTED
      title: HosRecordStatusCodeEnum
      description: Enum for HOS record status codes
    HosRecordOriginCodeEnum:
      type: string
      enum:
        - AUTO
        - DRIVER_EDIT
        - USER_EDIT
        - UNIDENTIFIED
      title: HosRecordOriginCodeEnum
      description: Enum for HOS record origin codes
    HosMalfunctionCodeEnum:
      type: string
      enum:
        - POWER
        - ENGINE_SYNC
        - TIMING
        - POSITION
        - RECORDING
        - TRANSFER
        - OTHER
        - DIAG_POWER
        - DIAG_ENGINE_SYNC
        - DIAG_MISSING_DATA
        - DIAG_TRANSFER
        - DIAG_UNIDENTIFIED
        - DIAG_OTHER
      title: HosMalfunctionCodeEnum
      description: Enum for HOS malfunction and diagnostic codes
    HosRegionCodeEnum:
      type: string
      enum:
        - US-AL
        - US-AK
        - US-AR
        - US-AZ
        - US-CA
        - US-CO
        - US-CT
        - US-DE
        - US-FL
        - US-GA
        - US-HI
        - US-IA
        - US-ID
        - US-IL
        - US-IN
        - US-KS
        - US-KY
        - US-LA
        - US-MA
        - US-MD
        - US-ME
        - US-MI
        - US-MN
        - US-MO
        - US-MS
        - US-MT
        - US-NC
        - US-ND
        - US-NE
        - US-NH
        - US-NJ
        - US-NM
        - US-NV
        - US-NY
        - US-OH
        - US-OK
        - US-OR
        - US-PA
        - US-RI
        - US-SC
        - US-SD
        - US-TN
        - US-TX
        - US-UT
        - US-VA
        - US-VT
        - US-WA
        - US-WI
        - US-WV
        - US-WY
        - US-DC
        - US-AS
        - US-GU
        - US-MP
        - US-PR
        - US-VI
        - CA-AB
        - CA-BC
        - CA-MB
        - CA-NB
        - CA-NF
        - CA-NS
        - CA-NT
        - CA-ON
        - CA-PE
        - CA-QC
        - CA-SK
        - CA-YT
        - CA-NL
        - MX-AG
        - MX-BN
        - MX-BS
        - MX-CH
        - MX-CI
        - MX-CL
        - MX-CP
        - MX-CS
        - MX-DF
        - MX-DG
        - MX-GE
        - MX-GJ
        - MX-HD
        - MX-JA
        - MX-MC
        - MX-MR
        - MX-MX
        - MX-NA
        - MX-NL
        - MX-OA
        - MX-PU
        - MX-QE
        - MX-QI
        - MX-SI
        - MX-SL
        - MX-SO
        - MX-TA
        - MX-TB
        - MX-TL
        - MX-VC
        - MX-YU
        - MX-ZA
      title: HosRegionCodeEnum
      description: Enum for HOS region codes
    Point:
      properties:
        bbox:
          anyOf:
            - prefixItems:
                - type: number
                - type: number
                - type: number
                - type: number
              type: array
              maxItems: 4
              minItems: 4
            - prefixItems:
                - type: number
                - type: number
                - type: number
                - type: number
                - type: number
                - type: number
              type: array
              maxItems: 6
              minItems: 6
            - type: 'null'
          title: Bbox
        type:
          type: string
          const: Point
          title: Type
        coordinates:
          anyOf:
            - $ref: '#/components/schemas/Position2D'
            - $ref: '#/components/schemas/Position3D'
          title: Coordinates
      type: object
      required:
        - type
        - coordinates
      title: Point
      description: Point Model
    InferredAddress:
      properties:
        city:
          anyOf:
            - type: string
            - type: 'null'
          title: City
        province:
          anyOf:
            - type: string
            - type: 'null'
          title: Province
        country_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Country Code
      type: object
      title: InferredAddress
      description: Inferred location, reverse-geocoded from lat/long
    Position2D:
      prefixItems:
        - type: number
          title: Longitude
        - type: number
          title: Latitude
      type: array
      maxItems: 2
      minItems: 2
    Position3D:
      prefixItems:
        - type: number
          title: Longitude
        - type: number
          title: Latitude
        - type: number
          title: Altitude
      type: array
      maxItems: 3
      minItems: 3
  securitySchemes:
    Bearer:
      type: oauth2
      flows:
        clientCredentials:
          refreshUrl: >-
            https://auth.catenatelematics.com/realms/catena/protocol/openid-connect/token
          scopes: {}
          tokenUrl: >-
            https://auth.catenatelematics.com/realms/catena/protocol/openid-connect/token
        authorizationCode:
          refreshUrl: >-
            https://auth.catenatelematics.com/realms/catena/protocol/openid-connect/token
          scopes: {}
          authorizationUrl: >-
            https://auth.catenatelematics.com/realms/catena/protocol/openid-connect/auth
          tokenUrl: >-
            https://auth.catenatelematics.com/realms/catena/protocol/openid-connect/token

````