​
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:
Sandbox: https://sandbox.antei.com
The production base URL is:
Live: https://api.antei.com
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 GroupRate Limit
/v1/tax/rate, /v1/tax/id-validate, /v1/tax/unify30 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

FeatureSandbox Behavior
Tax CalculationsReturns simulated rates, not real authority values
Tax ID ValidationUses static mock datasets and deterministic behavior
Rate LimitingStricter limits to encourage efficient testing
Data PersistenceTemporary — data may be cleared regularly
Billing & InvoicingNot 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-keys in 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.