Sandbox Environment

The FlexOps sandbox lets you test your integration without creating real shipments or incurring charges.

Base URL

https://sandbox.flexops.io/v1

All API endpoints are available in sandbox mode with the same request/response format as production.

Getting sandbox credentials

1. Sign in to the FlexOps Dashboard
2. Navigate to Settings > API Keys
3. Copy your Sandbox API Key (prefixed with sk_test_)

tip

Sandbox and production API keys are separate. Sandbox keys only work against the sandbox URL, and production keys only work against the production URL.

What works in sandbox

Feature	Behavior
Rate shopping	Returns simulated rates from all carriers
Label creation	Generates test labels with valid tracking numbers
Address validation	Full validation against USPS/carrier databases
Tracking	Returns simulated tracking events (see Test Data)
Webhooks	Delivers real webhook events to your endpoint
Batch operations	Full batch processing with simulated results
Analytics	Returns sample analytics data

Sandbox limits

Limit	Value
Rate limit	60 requests/minute (same as Starter plan)
Label retention	30 days
Webhook delivery	100 events/day
Batch size	50 shipments (reduced from 500 in production)

Verify your setup

After obtaining your sandbox key, verify it works:

curl -X GET https://sandbox.flexops.io/v1/carriers \
  -H "X-API-Key: sk_test_your_sandbox_key"

A successful response confirms your credentials are configured correctly.

Promoting to production

When you're ready to go live:

1. Replace sandbox.flexops.io with api.flexops.io
2. Replace your sandbox API key with a production key (sk_live_ prefix)
3. Ensure your webhook URLs point to your production server
4. Fund your wallet balance for label purchases