---
title: "Subscribe to the location of a vehicle or an asset"
method: POST
path: "/v1/freight_visibility/subscribe"
---

# Subscribe to the location of a vehicle or an asset

`POST /v1/freight_visibility/subscribe`

## Query parameters

- `company_id` string
- `dot_id` string
- `asset_id` string
- `vehicle_id` string
- `vehicle_name` string
- `driver_id` string
- `start_time` string, date, required
- `end_time` string, date, required
- `load_id` string
- `load_details` string
- `initial_stop` object
  - `lat` number, float — Specify the latitude coordinates of the initial load point.
  - `lon` number, float — Specify the longitude coordinates of the initial load point.
- `final_stop` object
  - `lat` number, float — Specify the latitude coordinates of the final drop point.
  - `lon` number, float — Specify the longitude coordinates of the final drop point.
- `total_distance` object
  - `value` number, float — Passed in by client for client side tracking. Sent back to client in response payload containing location.
  - `unit` string — [“km”, “mi”] Passed in by client for client side tracking. Sent back to client in response payload containing location.
- `trailer_id` string
- `broker_name` string

## Response `200`

200

- object
  - `data` object
    - `tracking_subscription_id` integer

## Other responses

- `400` — 400
- `403` — 403

---

[API](https://skmtc.net/gomotive/apis/motive.md) · [All operations](https://skmtc.net/gomotive/apis/motive/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gomotive/motive/revisions/c71780e497f5/schema)