> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trackstarhq.com/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> Trackstar is a unified REST API for WMS, cart, and carrier systems. Base URL: https://production.trackstarhq.com. There is no SDK; call the API with plain HTTP.
> Send x-trackstar-api-key on every request. Endpoints scoped to one connection also need x-trackstar-access-token. Read both from environment variables and never print them.
> Reads return data Trackstar has already synced from the connected system. Writes (POST, PUT, PATCH, DELETE) are forwarded to the connected system immediately.
> A new connection has no data until its initial sync finishes. Wait for the connection.historical-sync-completed webhook, or poll GET /connections/{connection_id} and check historical_sync_completed.
> List endpoints page with page_token and next_token (limit is capped at 1000). Repeat every filter on every page. Filters use field[operator]=value, for example created_date[gte]=2026-01-01T00:00:00Z.
> Write bodies must not contain null or empty strings; omit the field instead. Call GET /integrations/{integration_type}/{integration_name}/write-info first to learn the exact fields an integration accepts.
> To test without real credentials, POST /sandbox/generate-sandbox/{wms|cart|carrier} with the API key returns a sandbox access token. Start at https://docs.trackstarhq.com/how-to-guides/build-with-ai.md and install the skills with: npx skills add https://docs.trackstarhq.com
# Sandbox
> Test against mocked WMS, Cart, and Carrier data before connecting real systems
Trackstar provides sandbox environments for testing and development. Each sandbox contains mocked data so you can get familiar with the API and test your integrations without affecting production data.
There are three sandboxes, one for each API vertical:
* **WMS Sandbox** — orders, inventory, products, returns, and more
* **Cart Sandbox** — orders, products, and warehouses
* **Carrier Sandbox** — invoice line items
## 1. Get an API key
You will need an API key to make API calls. See the [Getting Started](/how-to-guides/getting-started#1-get-an-api-key)
page for how to get one.
## 2. Get your Sandbox Access Token
We automatically generate sandbox data for each vertical when you sign up for Trackstar. Navigate to the [connections page](https://dashboard.trackstarhq.com/connections) and
find the connection rows with Integration Name "Sandbox". Click on the key icon to get the access token for the sandbox you want to use.
## 3. Make API calls
Now you can use the API Key and Access Token to make API calls to the sandbox.
```python WMS Sandbox theme={null}
import requests
url = "https://production.trackstarhq.com/wms/inventory"
headers = {
"x-trackstar-api-key": "YOUR_API_KEY",
"x-trackstar-access-token": "YOUR_WMS_SANDBOX_ACCESS_TOKEN"
}
response = requests.get(url, headers=headers)
response.raise_for_status()
data = response.json()
```
```python Cart Sandbox theme={null}
import requests
url = "https://production.trackstarhq.com/cart/orders"
headers = {
"x-trackstar-api-key": "YOUR_API_KEY",
"x-trackstar-access-token": "YOUR_CART_SANDBOX_ACCESS_TOKEN"
}
response = requests.get(url, headers=headers)
response.raise_for_status()
data = response.json()
```
```python Carrier Sandbox theme={null}
import requests
url = "https://production.trackstarhq.com/carrier/invoice-line-items"
headers = {
"x-trackstar-api-key": "YOUR_API_KEY",
"x-trackstar-access-token": "YOUR_CARRIER_SANDBOX_ACCESS_TOKEN"
}
response = requests.get(url, headers=headers)
response.raise_for_status()
data = response.json()
```
You can read the API reference for all supported operations.
## 4. Sandbox Integration in Trackstar Link
You can enable Sandbox integrations in Trackstar Link by setting the `sandbox` prop in the [Trackstar React Component](/how-to-guides/getting-started#4-implement-react-trackstar-link-fe).
If you go through the auth flow for a Sandbox integration, it will return an auth code that you can [exchange for an access token](/api-reference/mgmt/exchange-auth-code).
This is useful for:
1. Testing the end-to-end Trackstar integration flow without needing real integration credentials.
2. Completing the link exchange generates sandbox data and returns an access token that you can use to make API calls to the sandbox. (Like in step 2 above)
## 5. Data Explorer
The Trackstar Dashboard includes a **Data Explorer** that lets you view and edit data directly in the browser. This is available for both sandbox and production connections.
Navigate to the [Data Explorer](https://dashboard.trackstarhq.com/data-explorer) in the dashboard to:
* Browse all resources (orders, inventory, products, etc.) for any connection
* Edit sandbox data to simulate scenarios like fulfilling an order or updating inventory
* View production data to debug issues or verify sync results
* Switch between WMS, Cart, and Carrier tabs and toggle between Sandbox and Production data
All changes made to sandbox data through the Data Explorer will trigger webhooks, so you can test your full integration flow end-to-end.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.