HOSconnect API (1.1.1)

Programming guide to the HOS platform

authentication

Response property accessToken All API requests should use "accessToken" as bearer token

authentication

Request Body schema: application/json
user
required
string

User login

password
required
string

Password

company
string

Company ID. Required for auth token that will be used for all requests except /companies endpoint

Responses

Request samples

Content type
application/json
{
  • "user": "string",
  • "password": "string",
  • "company": "string"
}

Response samples

Content type
application/json
{
  • "accessToken": "string"
}

latest_vehicle_statuses

Current vehicle status information

latest_vehicle_statuses

Authorizations:
auth_token
query Parameters
vehicleId
string

ID of the vehicle

$skip
integer >= 0

Number of records you want to skip (can be used for paging)

$limit
integer >= 0

Number of records you want to fetch (can be used for paging)

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

latest_driver_statuses

Current driver status information

latest_driver_statuses

Authorizations:
auth_token
query Parameters
userId
string

ID of the driver

$skip
integer >= 0

Number of records you want to skip (can be used for paging)

$limit
integer >= 0

Number of records you want to fetch (can be used for paging)

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

vehicles

All company vehicles

vehicles

Authorizations:
auth_token
query Parameters
$skip
integer >= 0

Number of records you want to skip (can be used for paging)

$limit
integer >= 0

Number of records you want to fetch (can be used for paging)

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

vehicle

Get vehicle by ID

Authorizations:
auth_token

Responses

Response samples

Content type
application/json
{
  • "_id": "string",
  • "name": "string",
  • "vin": "string",
  • "active": true,
  • "companyId": "string"
}

drivers

All company drivers

drivers

Authorizations:
auth_token
query Parameters
$skip
integer >= 0

Number of records you want to skip (can be used for paging)

$limit
integer >= 0

Number of records you want to fetch (can be used for paging)

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

driver

Get driver by ID

Authorizations:
auth_token

Responses

Response samples

Content type
application/json
{
  • "_id": "string",
  • "username": "string",
  • "firstName": "string",
  • "lastName": "string",
  • "companyId": "string"
}

companies

All provider companies

companies

Authorizations:
auth_token
query Parameters
$skip
integer >= 0

Number of records you want to skip (can be used for paging)

$limit
integer >= 0

Number of records you want to fetch (can be used for paging)

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

company

Get company by ID

Authorizations:
auth_token

Responses

Response samples

Content type
application/json
{
  • "_id": "string",
  • "name": "string"
}