/api/p/v{version}/visibility/outbound/{loadNumber}/history

This endpoint provides access to outbound updates for a specific load by using the loadNumber and version in your request. To use outbound visibility, customers must first set up an EDI integration in EDI Tenders. Auto-updates can be configured either in EDI Tenders or on the Company Details page within Alvys platform. Based on the configured auto-updates settings, the updates are shared automatically, including event type details, location, date shared, and the error details if any issues encountered. For more information on how versioning works and how to include it in your requests, please refer to 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.

Example CURL Request

curl --location 'https://integrations.alvys.com/api/p/v1/visibility/outbound/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 outbound 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 update.
locationId	String	The ID of the location related to the update.
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.: "AY" - Missed Pickup
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-002",
    "tripNumber": "TRIP54321",
    "loadNumber": "LOAD54321",
    "eventType": "Location",
    "sharedAt": "2024-11-11T15:06:23.767Z",
    "destination": "New York, NY",
    "truckNumber": "TRK12345",
    "driverName": "Jane Doe",
    "trailerNumber": "TRL54321",
    "stopId": "STOP002",
    "locationId": "LOC002",
    "sharedBy": "EDI System",
    "reason": "AY", //MP - Missed Pickup
    "address": {
      "street": "456 Elm St",
      "city": "New York",
      "state": "NY",
      "zipCode": "10001"
    },
    "coordinates": {
      "latitude": "40.712776",
      "longitude": "-74.005974"
    },
    "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.