Skip to main content

Overview

This page includes test tracking numbers you can use to make sure your tracking request integration works as planned.

What are test numbers?

Test numbers are deterministic request numbers for the Tracking Request API. Each number has a specific outcome, so you can test how your integration handles tracking_request.succeeded and tracking_request.failed without using a live shipment. Test numbers do not simulate every milestone, ETA, LFD, or availability event. To test your webhook handler for a specific event payload, use the Trigger Webhook endpoint.

Tracking request API

Shipments are created by making requests to the tracking request API. When using the API , ensure that:
  • you set the test number in request_number attribute in the request body
  • you set the scac attribute to TEST in the request body

Test numbers

Number.Use Case
TEST-TR-SUCCEEDEDTest the tracking_request.succeeded outcome and webhook
TEST-TR-FAILEDTest the tracking_request.failed outcome and webhook