List HOS Logs

GET

hos

logs

curl --request GET \
  --url https://api.withterminal.com/tsp/v1/hos/logs \
  --header 'Authorization: Bearer <token>' \
  --header 'Connection-Token: <connection-token>'

{
  "results": [
    {
      "id": "hos_log_01D8ZQFGHVJ858NBF2Q7DV9MNC",
      "sourceId": "123456789",
      "provider": "geotab",
      "status": "off_duty",
      "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",
          "notes": "<string>"
        }
      ],
      "raw": []
    }
  ],
  "next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Connection-Token

string

required

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

Example:

"con_tkn_22vUhkC6tgre4kwaYfUkCDA1rzn6eyb4"

Query Parameters

cursor

string

Pagination cursor to start requests from

Example:

"cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw"

limit

integer

The maximum number of results to return in a page.

startedAfter

string

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

Example:

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

startedBefore

string

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

Example:

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

modifiedAfter

string

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

Example:

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

modifiedBefore

string

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

Example:

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

driverIds

string

Comma separated list of driver IDs to filter for. Can filter up to 50 drivers at a time.

expand

enum<string>

Expand resources in the returned response

Available options:

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

raw

boolean

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

Response

200

application/json

results

object[]

required

Records a change in duty status by a driver

results.id

string

required

Example:

"hos_log_01D8ZQFGHVJ858NBF2Q7DV9MNC"

results.sourceId

string

required

The ID used to represent the entity in the source system.

Example:

"123456789"

results.provider

enum<string>

required

Available options:

azuga,

bigroad,

conti-go,

eld-mandate,

eld-mandate-plus,

eld-mandate-hos,

eld-rider,

eldone,

envue-telematics,

eroad,

eva-eld,

attrix,

advantage-one,

argos,

fleet-profit-center,

gps-tracking-canada,

graybox-solutions,

gridline,

high-point-gps,

io-tab,

blue-arrow,

eagle-wireless,

fleet-complete-hub,

fleetistics,

fort-knox,

fm-eld,

geotab,

gofleet,

gogps,

gps-insight,

gpstab,

isaac,

ksk,

switchboard,

linxup,

coretex-360,

apollo,

apollo-eld,

apollo-compass,

top-tracking-system,

eld-mandate-prime,

hos-reporter-plus,

hos247,

black-bear,

columbus-eld,

phoenix-eld,

route-eld,

reliable-eld,

trust-eld,

abc-eld,

tempus-eld,

vlog-eld,

just-eld,

factor-eld,

moonlight-eld,

daily-eld,

dfl-eld,

hero-eld,

infinity-eld,

ampm-eld,

forza-eld,

action-eld,

state-elog,

dy-eld,

cobra-eld,

flash-elogs,

renaissance-eld,

robinhood-eld,

sr-eld,

speedline-eld,

eld-2-go,

captain-eld,

ironman-eld,

powertrucks-eld,

paragon-eld,

youlog-eld,

legacy-eld,

master-eld,

monarch-tracking,

motive,

mountain-eld,

omnitracs-es,

omnitracs-xrs,

omnitracs,

one-step-gps,

optima-eld,

pro-ride-eld,

pti-eld,

real-eld,

right-trucking,

roadstar,

routemate,

samsara,

sandbox,

sparkle-eld,

tx-eld,

surfsight,

tfm-eld,

transflo,

truckx,

tt-eld,

verizon-fleet,

verizon-reveal,

verizon,

webfleet,

xeld,

xplore-eld,

zonar,

geotab-att,

zippy-eld,

evo-eld,

ontime-eld,

intelli-shift,

id-eld,

max-eld,

asrit-solutions,

smartelds,

eld-books,

vulcansols,

motion-eld,

blue-horse-eld,

apex-ultima,

radical-eld,

rock-eld,

lytx,

blue-ink,

utech,

light-and-travel-eld,

lion-eight,

pop-eld,

netradyne,

people-net

Example:

"geotab"

results.status

enum<string>

required

Available options:

off_duty,

sleeper_bed,

driving,

on_duty,

yard_move,

personal_conveyance,

waiting_time

results.driver

required

Reference to the driver for this log

Example:

"drv_01D8ZQFGHVJ858NBF2Q7DV9MNC"

results.startedAt

string

required

ISO 8601 date

Example:

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

results.remarks

object[]

required

results.vehicle

The vehicle the driver was driving when the log was recorded.

Example:

"vcl_01D8ZQFGHVJ858NBF2Q7DV9MNC"

results.codrivers

array

Additional drivers that were included in the HOS log.

Entities in Terminal are expandable. Using the expand query parameter you can choose to ingest just an ID or the full entity details.

results.endedAt

string

ISO 8601 date

Example:

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

results.location

object

Where the log was recorded

results.raw

object[]

List of the raw data used to normalize the common model. Response schemas will vary by provider.

Raw data fetched from the source provider. Most of our endpoints support a raw query parameter that will append a list of the raw requests used to form our common model. This can be helpful for leveraging unique fields that are not part of our unified model.

Example:

[]

string

Cursor used for pagination.

Example:

"cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw"

Available Time for Drivers List HOS Daily Logs

curl --request GET \
  --url https://api.withterminal.com/tsp/v1/hos/logs \
  --header 'Authorization: Bearer <token>' \
  --header 'Connection-Token: <connection-token>'

{
  "results": [
    {
      "id": "hos_log_01D8ZQFGHVJ858NBF2Q7DV9MNC",
      "sourceId": "123456789",
      "provider": "geotab",
      "status": "off_duty",
      "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",
          "notes": "<string>"
        }
      ],
      "raw": []
    }
  ],
  "next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw"
}

API Reference

Authentication

Vehicles

Drivers

Hours of Service

Trips

Devices

Safety

Groups

Trailers

IFTA

Connections

Data Management

Providers

Issues

Webhook Events

Authorizations

Headers

Query Parameters

Response