---
title: "Available Time for Drivers"
method: GET
path: "/hos/available-time"
tags: ["Hours of Service"]
---

# Available Time for Drivers

`GET /hos/available-time`

List available time for the driver. This endpoint provides live access to the driver's available time. Different than most endpoints, this endpoint calls the provider's API in real time to get the latest available time for the driver. This endpoint is useful for building real time applications that need to know the driver's available time.

## Query parameters

- `cursor` string, cursor
- `limit` integer
- `driverIds` string
- `expand` 'driver'
- `raw` boolean

## Headers

- `X-Application-Id` string
- `Connection-Token` string, required

## Response `200`

OK

- object
  - `results` object[], required
    - `provider` string, required — Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers).
    - `driver` union, required — Reference to the driver for this log
      - string, ulid — Unique identifier for the driver in Terminal.
      - object
        - `id` string, ulid, required — Unique identifier for the driver in Terminal.
    - `currentStatus` 'off_duty' | 'sleeper_bed' | 'driving' | 'on_duty' | 'yard_move' | 'personal_conveyance' | 'waiting_time' — The current status of the driver
    - `currentStatusStartedAt` string, date-time — [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date
    - `availableTime` object, required — Available time remaning in milliseconds
      - `cycle` integer — The total remaining time for the driver's current cycle (ex: 70 hours). Value is in milliseconds.
      - `shift` integer — The total remaining time for the driver's current shift (ex: 14 hours). Value is in milliseconds.
      - `drive` integer — The total remaining drive time for the driver's current shift (ex: 11 hours). Value is in milliseconds.
      - `break` integer — The amount of time before the next break is required (ex: 8 hours). Value is in milliseconds.
    - `raw` object[]
      - `provider` string, required
      - `schema` string, required
      - `extractedAt` string, required
      - `data` object, required
  - `next` string, cursor — Cursor used for pagination.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error
- `501` — Not Implemented
- `502` — Bad Gateway
- `503` — Provider Unavailable Error
- `504` — Gateway Timeout Error

---

[API](https://skmtc.dev/withterminal/apis/terminal-telematics-api.md) · [All operations](https://skmtc.dev/withterminal/apis/terminal-telematics-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withterminal/terminal-telematics-api/revisions/90249c4a1739/schema)