/api/p/v{version}/visibility/outbound/errors

This endpoint allows you to retrieve a paginated list of outbound errors for a specified time range. The request includes parameters for pagination and a time range filter. Note that the time range must be 7 days or less. This feature helps users identify and manage any errors that occurred while sharing updates with external systems.

Request Body Parameters

All the following parameters are required in the request body:

Parameter	Type	Required	Description
page	Number	Yes	The page number to retrieve.
pageSize	Number	Yes	The number of items to retrieve per page.
timeRange	Object	Yes	The time range filter for retrieving errors. Must be 7 days or less.
timeRange.start	String (Date-Time)	Yes	The start date and time for the time range.
timeRange.end	String (Date-Time)	Yes	The end date and time for the time range.

Example CURL Request

curl --location 'https://integrations.alvys.com/api/p/v1/visibility/outbound/errors' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page": 0,
    "pageSize": 10,
    "timeRange": {
        "start": "2024-11-11T15:15:13.876Z",
        "end": "2024-11-18T15:15:13.876Z"
    }
}'

Replace YOUR_ACCESS_TOKEN with your actual Bearer token. Ensure that the start and end dates are within a 7-day range.

Response Fields

The response is a paginated list of error items, including details about each error:

Field	Type	Description
page	Number	The current page number.
pageSize	Number	The number of items per page.
total	Number	The total number of error items.
items	Array	A list of error items.
items.id	String	The unique identifier of the error.
items.externalId	String	The external ID related to the error.
items.tripNumber	String	The trip number linked to the load.
items.loadNumber	String	The load number for which the error occurred.
items.eventType	String	The type of event, typically "Location".
items.sharedAt	String (Date-Time)	The date and time when the update was shared.
items.destination	String	The destination of the load.
items.truckNumber	String	The number of the truck transporting the load.
items.driverName	String	The name of the driver.
items.trailerNumber	String	The number of the trailer being used.
items.stopId	String	The ID of the stop related to the error.
items.locationId	String	The ID of the location associated with the error.
items.sharedBy	String	The entity (user or system) that shared the update.
items.reason	String	The reason for the error, if provided. There is defined list on system, depending on integration. E.g.: NS - Normal Status.
items.address	Object	The address details of the location update.
items.address.street	String	The street of the location.
items.address.city	String	The city of the location.
items.address.state	String	The state of the location.
items.address.zipCode	String	The postal code of the location.
items.coordinates	Object	The geographic coordinates of the location.
items.coordinates.latitude	String	The latitude of the location.
items.coordinates.longitude	String	The longitude of the location.
items.status	String	The status of the update (e.g., "Completed", "Failed").
items.error	String	The error message related to the update.

Example Response

{
  "page": 0,
  "pageSize": 10,
  "total": 1,
  "items": [
    {
      "id": "9b834b4c77124b8f8f0d97b56b7dabc4",
      "externalId": "EXT-003",
      "tripNumber": "TRIP67890",
      "loadNumber": "LOAD67890",
      "eventType": "Location",
      "sharedAt": "2024-11-11T15:15:13.896Z",
      "destination": "Chicago, IL",
      "truckNumber": "TRK67890",
      "driverName": "Alex Johnson",
      "trailerNumber": "TRL67890",
      "stopId": "STOP003",
      "locationId": "LOC003",
      "sharedBy": null,
      "reason": "NS", //normal status
      "address": {
        "street": "789 Oak St",
        "city": "Chicago",
        "state": "IL",
        "zipCode": "60601"
      },
      "coordinates": {
        "latitude": "41.878113",
        "longitude": "-87.629799"
      },
      "status": "Failed",
      "error": "EDI|Failed to send message to General Mills via EDI. Please try again or reach out to support if the problem persist."
    }
  ]
}

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 test the endpoint by providing the required request body. The CURL command will update automatically based on your inputs. You can also try this request by forking our Public API Postman Collection. Remember to authorize yourself before trying a request.