Get inbound visibility history

GET

api

{version}

visibility

inbound

{loadNumber}

history

Get inbound visibility history

curl --request GET \
  --url https://integrations.alvys.com/api/p/v{version}/visibility/inbound/{loadNumber}/history \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://integrations.alvys.com/api/p/v{version}/visibility/inbound/{loadNumber}/history', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://integrations.alvys.com/api/p/v{version}/visibility/inbound/{loadNumber}/history"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://integrations.alvys.com/api/p/v{version}/visibility/inbound/{loadNumber}/history",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://integrations.alvys.com/api/p/v{version}/visibility/inbound/{loadNumber}/history"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

[
  {
    "Id": "<string>",
    "SharedAt": "2023-11-07T05:31:56Z",
    "Destination": "<string>",
    "ExternalId": "<string>",
    "TripNumber": "<string>",
    "LoadNumber": "<string>",
    "TruckNumber": "<string>",
    "DriverName": "<string>",
    "TrailerNumber": "<string>",
    "StopId": "<string>",
    "LocationId": "<string>",
    "SharedBy": "<string>",
    "Reason": "<string>",
    "Address": {
      "Street": "<string>",
      "City": "<string>",
      "State": "<string>",
      "ZipCode": "<string>"
    },
    "Coordinates": {
      "Latitude": "<string>",
      "Longitude": "<string>"
    },
    "Error": "<string>"
  }
]

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

The location history endpoint provides access to inbound updates for a specific load by using the loadNumber and version in your request. The history includes location updates from various sources, such as ELD integrations (if enabled for assets), manual Checkcalls, EDI & Visibility integrations, or updates from the driver app. These updates help track the load’s location, detailing event types, timestamps, and asset information. For guidance on versioning and how to include it in your requests, visit the Versioning page.

Request Parameters

The following parameters are required in the URL:

Parameter	Type	Required	Description
version	String	Yes	The API version you are using (e.g., “v1”).
loadNumber	String	Yes	The unique number assigned to the load for tracking purposes.

Example CURL Request

curl --location 'https://integrations.alvys.com/api/p/v1/visibility/inbound/12345/history' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Replace YOUR_ACCESS_TOKEN with your actual Bearer token and 12345 with the load number you wish to track.

Response Fields

The following fields are included in the response:

Field	Type	Description
Id	String	The unique identifier of the location update.
ExternalId	String	The external ID related to the update.
TripNumber	String	The trip number linked to the load.
LoadNumber	String	The load number for which the update is recorded.
EventType	String	The type of event, typically “Location”.
SharedAt	String (Date-Time)	The date and time when the update was shared.
Destination	String	The destination of the load.
TruckNumber	String	The number of the truck transporting the load.
DriverName	String	The name of the driver.
TrailerNumber	String	The number of the trailer being used.
StopId	String	The ID of the stop associated with the location update.
LocationId	String	The ID of the location where the update occurred.
SharedBy	String	The entity (user or system) that shared the update.
Reason	String	The reason for the update, if provided. There is defined list on system, depending on integration. E.g.: “NA”- Normal Appointment.
Address	Object	The address details of the location update.
Address.Street	String	The street of the location.
Address.City	String	The city of the location.
Address.State	String	The state of the location.
Address.ZipCode	String	The postal code of the location.
Coordinates	Object	The geographic coordinates of the location.
Coordinates.Latitude	String	The latitude of the location.
Coordinates.Longitude	String	The longitude of the location.
Status	String	The status of the update (e.g., “Completed”, “Failed”).
Error	String	Any error message, if the update could not be processed.

Example Response

[
  {
    "Id": "9b834b4c77124b8f8f0d97b56b7dabc4",
    "ExternalId": "EXT-001",
    "TripNumber": "TRIP12345",
    "LoadNumber": "LOAD12345",
    "EventType": "Location",
    "SharedAt": "2024-11-11T15:02:49.233Z",
    "Destination": "Los Angeles, CA",
    "TruckNumber": "TRK98765",
    "DriverName": "John Doe",
    "TrailerNumber": "TRL12345",
    "StopId": "STOP001",
    "LocationId": "LOC001",
    "SharedBy": "TMS System",
    "Reason": "NA",//Normal Appointment
    "Address": {
      "Street": "123 Main St",
      "City": "Los Angeles",
      "State": "CA",
      "ZipCode": "90001"
    },
    "Coordinates": {
      "Latitude": "34.052235",
      "Longitude": "-118.243683"
    },
    "Status": "Completed",
    "Error": ""
  }
]

Rate Limits

All endpoints are subject to rate limits to protect the API from traffic spikes. For detailed information on rate limits, please refer to the Rate Limits section. This page is interactive, allowing you to try a request by completing the fields for the parameters below. As you fill out the parameters, the CURL command on the right side of the page will be automatically updated. Alternatively, you can fork our Public API Postman Collection directly. Make sure to authorize yourself before trying a request.

Authorizations

Authorization

string

header

required

OAuth 2.0 client-credentials access token. Obtain one from https://auth.alvys.com/oauth/token (grant_type=client_credentials, audience=https://api.alvys.com/public/), then paste it here. The playground sends it as Authorization: Bearer <token>.

Path Parameters

loadNumber

string

required

version

string

default:1.0

required

API version (e.g., 1.0)

Example:

"1.0"

Response

string

required

EventType

enum<string>

required

Available options:

Location,

Arrival,

Departure,

Appointment,

Loading,

Unloading,

ShipmentDelayed,

ShipmentReconsigned,

EstimatedDelivery,

DeliveryNotCompleted,

DocumentsUpload,

ArrivedAtCustoms,

CustomsReleased

SharedAt

string<date-time>

required

Destination

string

required

Status

enum<string>

required

Available options:

Completed,

Active,

Cancelled,

Failed

ExternalId

string | null

TripNumber

string | null

LoadNumber

string | null

TruckNumber

string | null

DriverName

string | null

TrailerNumber

string | null

StopId

string | null

LocationId

string | null

SharedBy

string | null

Reason

string | null

Address

object | null

Show child attributes

Coordinates

object | null

Show child attributes

Error

string | null

⌘I

Get inbound visibility history

curl --request GET \
  --url https://integrations.alvys.com/api/p/v{version}/visibility/inbound/{loadNumber}/history \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://integrations.alvys.com/api/p/v{version}/visibility/inbound/{loadNumber}/history', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://integrations.alvys.com/api/p/v{version}/visibility/inbound/{loadNumber}/history"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://integrations.alvys.com/api/p/v{version}/visibility/inbound/{loadNumber}/history",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://integrations.alvys.com/api/p/v{version}/visibility/inbound/{loadNumber}/history"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

[
  {
    "Id": "<string>",
    "SharedAt": "2023-11-07T05:31:56Z",
    "Destination": "<string>",
    "ExternalId": "<string>",
    "TripNumber": "<string>",
    "LoadNumber": "<string>",
    "TruckNumber": "<string>",
    "DriverName": "<string>",
    "TrailerNumber": "<string>",
    "StopId": "<string>",
    "LocationId": "<string>",
    "SharedBy": "<string>",
    "Reason": "<string>",
    "Address": {
      "Street": "<string>",
      "City": "<string>",
      "State": "<string>",
      "ZipCode": "<string>"
    },
    "Coordinates": {
      "Latitude": "<string>",
      "Longitude": "<string>"
    },
    "Error": "<string>"
  }
]

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

{
  "Type": "<string>",
  "Title": "<string>",
  "Status": 123,
  "Detail": "<string>",
  "Instance": "<string>"
}

​Request Parameters

​Example CURL Request

​Response Fields

​Example Response

​Rate Limits

Authorizations

Path Parameters

Response

Request Parameters

Example CURL Request

Response Fields

Example Response

Rate Limits