Sandbox Environment
Simulate and test your integration safely using Antei’s dedicated Sandbox environment.
What Is the Sandbox?
The Sandbox is a dedicated testing environment that mirrors the behavior of the Antei production API. It allows you to safely simulate requests, validate integration flows, and preview responses — without affecting live data or incurring charges.
Sandbox Base URL
Use the following base URL for all sandbox API calls:
The production base URL is:
Make sure you switch environments based on the stage of your development and deployment.
API Keys in Sandbox
To authenticate requests in the Sandbox, generate a Sandbox API Key from:
Settings → Integrations → Create API Key → Select “Sandbox”
Sandbox API keys are entirely separate from live keys and only work with the sandbox domain.
Rate Limits
Rate limits in the Sandbox are intentionally lower to simulate constrained production environments.
| API Group | Rate Limit |
|---|---|
/v1/tax/rate, /v1/tax/id-validate, /v1/tax/unify | 30 requests per minute |
Other endpoints (e.g., /customers, /invoices) | Not available in Sandbox |
Test Values for Simulation
The Sandbox supports specific input values to simulate deterministic behavior. You can use these values in your requests to test various scenarios.
Valid Tax ID Scenarios
Tax Rate Simulation
Behavior Differences from Production
| Feature | Sandbox Behavior |
|---|---|
| Tax Calculations | Returns simulated rates, not real authority values |
| Tax ID Validation | Uses static mock datasets and deterministic behavior |
| Rate Limiting | Stricter limits to encourage efficient testing |
| Data Persistence | Temporary — data may be cleared regularly |
| Billing & Invoicing | Not supported in Sandbox |
Important Notes
- Always check your base URL before going live.
- Use only supported test cases in the Sandbox for predictable outcomes.
- Use mock values to simulate edge cases (e.g., invalid tax IDs, unknown countries).
- Review Rate Limiting and Idempotency behaviors during integration.
Best Practices
- Test failure flows: invalid tax ID, incorrect categories, rate-limit breach.
- Use unique
idempotency-keysin retries to verify idempotent behavior. - Don’t use production keys or real customer data in Sandbox.
Need help? Contact support@antei.com with your request_id and environment info.