ShipEngine LTL Sandbox
ShipEngine API gives you the ability to test the LTL Workflow in ShipEngine using our sandbox. This will allow you to use our test LTL carriers to get comfortable with the process, and test that your application handles different scenarios properly before going to production.
Sandbox Access
Login to your ShipEngine dashboard and create a sandbox API key. If your ShipEngine account was created before Sandbox support, you will need to contact support to enable this feature for you. If that is the case, you will see a message in your ShipEngine Dashboard.
LTL Test Carriers
The ShipEngine API sandbox allows you to connect three different LTL test carriers to your ShipEngine account. Each of these carriers simulates a different condition your app might encounter when working with LTL shipments in ShipEngine API. The following test carriers are available in the ShipEngine sandbox.
TEST
- Use thiscarrier_code
to test successful scenarios. As long as the request is syntactically correct, you will always receive a successful response from this carrier.WARN
- Use thiscarrier_code
to test conditions that generate a warning, such as specifying an invalid accessorial service. As long as the request is syntactically correct, you will always receive a warning response from this carrier.FAIL
- Use thiscarrier_code
to test conditions that generate an error. As long as the request is syntactically correct, you will always receive an error response from this carrier.
Connect Carriers
You'll first need to connect each of the test carriers to your ShipEngine account before you can make requests.
To connect an LTL test carrier, send an
empty request body to the connection endpoint, inserting the preferred carrier_code
in the URL.
Example Request
POST/v-beta/ltl/connections/:carrier_code
Example Response
Responses
The data returned from these carriers will always be the same as long as the request is syntactically correct. Building your application to accept all three types of structured responses will ensure that when you move into production, you will have full support for all LTL carriers we integrate with.