> ## Documentation Index
> Fetch the complete documentation index at: https://docs.antei.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sandbox Environment

> Simulate and test your integration safely using Antei’s dedicated Sandbox environment.

<Icon icon="paper-plane" size={26} color="#4B5563" />

## 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:
<Check> Sandbox: [https://sandbox.antei.com](https://sandbox.antei.com) </Check>

The production base URL is:
<Warning> Live: [https://api.antei.com](https://api.antei.com) </Warning>

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

<Expandable title="Valid Tax ID- Sandbox">
  | Country | Tax ID            | Simulated Outcome      |
  | :------ | :---------------- | :--------------------- |
  | DE      | `DE123456789`     | Valid, matches name    |
  | IN      | `29ABCDE1234F1Z5` | Valid, mismatched name |
  | US      | `123-45-6789`     | Invalid                |
</Expandable>

### Tax Rate Simulation

<Expandable title="Valid Tax Rates- Sandbox">
  | Country | Product Category | Customer Type | Outcome Description    |
  | :------ | :--------------- | :------------ | :--------------------- |
  | DE      | `SAAS`           | `B2B`         | Reverse charge applied |
  | IN      | `PRSFT`          | `B2C`         | Standard GST 18%       |
  | US      | `CSS`            | `NGO`         | Tax-exempt scenario    |

  > You can mix and match valid combinations to simulate real-world use cases like exemption, reverse charge, invalid ID, and total tax.
</Expandable>

***

## 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](/api-reference/rate-limiting) and [Idempotency](/api-reference/idempotency-keys) 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](mailto:support@antei.com) with your `request_id` and environment info.