Skip to main content

Test Data Reference

Use these test addresses, tracking numbers, and scenarios in the sandbox environment to simulate specific carrier responses.

Test addresses​

Successful delivery​

ScenarioStreetCityStateZIPCountry
Standard delivery123 Main StDenverCO80202US
Residential delivery456 Oak AvePortlandOR97201US
Business delivery789 Commerce BlvdAustinTX78701US
PO BoxPO Box 1234SeattleWA98101US

Address correction​

ScenarioInputCorrected
ZIP correction456 Oak Ave, Portland OR 97200456 Oak Ave, Portland OR 97201-1234
Suite normalization100 Broadway Ste 5100 Broadway Suite 5
State abbreviation789 Main St, California789 Main St, CA

Validation failures​

StreetCityStateZIPError code
999 Nowhere LnFakevilleXX00000INVALID_ADDRESS
100 Main StDenverCO99999INVALID_ADDRESS (ZIP mismatch)

Test tracking numbers​

Use these tracking numbers with GET /v1/tracking/:trackingNumber to simulate specific delivery scenarios:

USPS​

Tracking NumberScenario
9400111899223456789012Delivered successfully
9400111899223456789029In transit (3 events)
9400111899223456789036Out for delivery
9400111899223456789043Delivery exception — no access
9400111899223456789050Returned to sender
9400111899223456789067Delivery attempted — business closed

FedEx​

Tracking NumberScenario
794644790132Delivered — signed for
794644790149In transit — hub scan
794644790156Delivery exception — damaged
794644790163Customs hold (international)

UPS​

Tracking NumberScenario
1Z999AA10123456784Delivered
1Z999AA10123456791In transit
1Z999AA10123456808Exception — address correction needed

DHL​

Tracking NumberScenario
1234567890Delivered internationally
1234567907Customs clearance in progress
1234567914Held at customs — documents required

Test parcels​

Standard sizes​

NameWeight (oz)L x W x H (in)Notes
Letter412 x 9 x 0.5USPS First Class eligible
Small box1610 x 8 x 4All carriers
Medium box4814 x 12 x 6All carriers
Large box16024 x 18 x 12Weight surcharge on some carriers
Oversize80048 x 30 x 24May trigger WEIGHT_EXCEEDS_LIMIT on some services

Edge cases​

ScenarioWeight (oz)DimensionsExpected behavior
Minimum weight16 x 4 x 1USPS First Class only
Maximum USPS112030 x 20 x 1470 lb USPS limit
Over USPS limit120030 x 20 x 14WEIGHT_EXCEEDS_LIMIT for USPS; FedEx/UPS still return rates
DIM weight trigger824 x 24 x 24Carriers apply dimensional weight pricing

Test carrier accounts​

In sandbox, all carriers are pre-configured. No carrier account setup is required.

CarrierSandbox behavior
USPSSimulated Commercial Plus pricing
FedExSimulated list rates with negotiated discount
UPSSimulated daily rates
DHLSimulated Express rates for international
Canada PostSimulated domestic/US rates
Royal MailSimulated UK domestic rates
Australia PostSimulated domestic rates

Test webhook events​

Trigger test webhook deliveries from the sandbox:

curl -X POST https://sandbox.flexops.io/v1/webhooks/:id/test \
  -H "X-API-Key: sk_test_your_sandbox_key"

This sends a sample tracking.updated event to your registered webhook URL with a valid HMAC signature.

International test scenarios​

FromToScenario
US (80202)CA (M5V 2T6)Canada — no customs hold
US (80202)GB (SW1A 1AA)UK — standard customs
US (80202)DE (10115)Germany — customs hold simulation
US (80202)AU (2000)Australia — prohibited item rejection

Test customs items​

DescriptionHS CodeValueScenario
Cotton T-Shirt6109.10$25.00Standard clearance
Electronics (phone)8517.12$999.00High-value inspection
Food samples2106.90$15.00Restricted — requires permit
Lithium battery8507.60$45.00Dangerous goods — CUSTOMS_REQUIRED with hazmat flag