WIwithterminal
Hours of Service

List HOS Logs

Changed on

List all hours of service logs. HOS logs are tracked as the distinct changes in duty status.

get/hos/logs

Request

  • Base URL
    https://api.withterminal.com/tsp/v1
  • URL
    https://api.withterminal.com/tsp/v1/hos/logs
  • Auth
    HTTP bearer

Query parameters

cursorstring cursor
Example:cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw

Pagination cursor to start requests from

limitinteger

The maximum number of results to return in a page.

startedAfterstring date-time

ISO 8601 date

Example:2021-01-06T03:24:53.000Z

Only include records of statuses that started after a provided date.

startedBeforestring date-time

ISO 8601 date

Example:2021-01-06T03:24:53.000Z

Only include records of statuses that started before a provided date.

modifiedAfterstring date-time
Example:2021-01-06T03:24:53.000Z

Only include records that were last modified after a provided date.

modifiedBeforestring date-time
Example:2021-01-06T03:24:53.000Z

Only include records that were last modified before a provided date.

driverIdsstring

Comma separated list of driver IDs to filter for. Can filter up to 50 drivers at a time. Each ID must use the drv_ prefix.

expand'driver' | 'vehicle' | 'codrivers' | 'driver,vehicle' | 'driver,codrivers' | 'vehicle,driver' | 'vehicle,codrivers' | 'codrivers,driver' | 'codrivers,vehicle' | 'driver,vehicle,codrivers' | 'driver,codrivers,vehicle' | 'vehicle,driver,codrivers' | 'vehicle,codrivers,driver' | 'codrivers,driver,vehicle' | 'codrivers,vehicle,driver'

Expand resources in the returned response

deletedboolean

Show "soft-deleted" records that have been deleted from the provider. Defaults to false.

rawboolean

Include raw responses used to normalize model. Used for debugging or accessing unique properties that are not unified.

Headers

X-Application-Idstring

Scopes the request to a Terminal application in the caller's organization. Required for multi-application organizations when using a user session or OAuth access token. API keys are already bound to a single application.

Connection-Tokenstring required
Example:con_tkn_22vUhkC6tgre4kwaYfUkCDA1rzn6eyb4

The token returned when a user authenticated their account. This authorizes access to a specific account.

Response

OK

nextstring cursor

Cursor used for pagination.

Example response

{
  "results": [
    {
      "id": "hos_log_01D8ZQFGHVJ858NBF2Q7DV9MNC",
      "sourceId": "123456789",
      "provider": "geotab",
      "driver": "drv_01D8ZQFGHVJ858NBF2Q7DV9MNC",
      "vehicle": "vcl_01D8ZQFGHVJ858NBF2Q7DV9MNC",
      "codrivers": [
        "drv_01D8ZQFGHVJ858NBF2Q7DV9MNC"
      ],
      "startedAt": "2021-01-06T03:24:53.000Z",
      "endedAt": "2021-01-06T03:24:53.000Z",
      "location": {
        "longitude": -122.4194155,
        "latitude": 37.7749295
      },
      "remarks": [
        {
          "sourceId": "123456789",
          "submittedAt": "2021-01-06T03:24:53.000Z"
        }
      ],
      "raw": []
    }
  ],
  "next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw"
}

Changes

  • 71081936e1bdRevision changes
    • breaking

      added the pattern ^[A-Za-z0-9+/=_-]+$ to the query request parameter cursor

    • breaking

      added to the /// response property oneOf list for the response status

    • breaking

      added to the // response property oneOf list for the response status

    • breaking

      added to the // response property oneOf list for the response status

    • warning

      added the new provider_timeout enum value to the response property for the response status

    • info

      added the new optional query request parameter deleted

    • info

      added the non-success response with the status

    • info

      added the optional property /// to the response with the status

    • info

      removed subschema #2: Expanded Driver from the /// response property oneOf list for the response status

    • info

      removed subschema #2: Expanded Driver from the // response property oneOf list for the response status

    • info

      removed subschema #2: Expanded Vehicle from the // response property oneOf list for the response status

    • info

      the response's property pattern ^[A-Za-z0-9+/=_-]+$ was added for the status