DevelopersGet started
Sandbox
The sandbox is a set of read-only sample accounts you can call the API against before you have data of your own: Demo Dental, a sample dental office, and Demo Voice, a sample reseller with three clients. Sandbox credentials aren't published: we share them on request.
Getting sandbox credentials
Email [email protected] (or ask your AssistCall contact) and tell us briefly what you're building. We'll send a client ID and secret for:
- Demo Dental: an account (client) key, for everything a business's own key can read;
- Demo Voice: a partner key, for the reseller endpoints and its clients' data.
Keep them to yourself like any other key; we can rotate them at any time.
Using them
Sandbox credentials work exactly like your own key: exchange them for a token at POST /v1/oauth/token, then call any read endpoint. In the API reference, open Try it on any endpoint and enter them in the key panel; they stay in your browser tab's memory only.
# the credentials we sent you, kept out of your shell history and code
export ASSISTCALL_CLIENT_ID="ac_cli_..."
export ASSISTCALL_CLIENT_SECRET="ac_sk_..."
TOKEN=$(curl -s https://api.assistcall.ai/v1/oauth/token \
-u "$ASSISTCALL_CLIENT_ID:$ASSISTCALL_CLIENT_SECRET" \
-d grant_type=client_credentials | jq -r .access_token)
curl "https://api.assistcall.ai/v1/calls?limit=3" -H "Authorization: Bearer $TOKEN"The partner key reads the partner itself (/v1/partner, /v1/clients, /v1/packages) and, with the AssistCall-Account header, any of its clients' data. Account ids are created when the demo is set up, so look them up with GET /v1/clients.
# with a token for the partner sandbox credentials: the partner's clients and their account ids
curl https://api.assistcall.ai/v1/clients -H "Authorization: Bearer $TOKEN"
# one client's calls: name it in AssistCall-Account
curl https://api.assistcall.ai/v1/calls \
-H "Authorization: Bearer $TOKEN" \
-H "AssistCall-Account: <Demo Dental's id from /v1/clients>"What’s in the sandbox
Everything is fictional: names, businesses, and phone numbers in the reserved 555-01xx range. Times are relative to when the demo was last refreshed, so a call "yesterday" drifts older until the next refresh.
Demo Dental (the client key)
- An AI Employee named Mia answering (212) 555-0101.
- 6 calls from the past week, each with a summary and transcript: new patients booking cleanings, an urgent cracked tooth, insurance and pricing questions, a reschedule and an after-hours question about payment plans.
- 2 messages, one marked urgent, and 3 upcoming appointments booked by the AI Employee.
- A New patient intake form (full name, insurance, reason for visit, how they heard about the office) with 2 answers.
- 4 knowledge entries: two packages (Cleaning and exam, $129 per visit; In-office whitening, $299) and two articles (which insurance is accepted, where to park).
- Contacts for each caller, and usage for the current period.
Demo Voice (the partner key)
| Client | Status | Package |
|---|---|---|
| Demo Dental | Active | Front Desk |
| Demo Heating & Air AI Employee Sam, 2 calls, 1 booking, 1 message | Active | Busy Office |
| Demo Law Group no AI Employee yet | Setting up | Pay As You Go |
| Package | Based on | Price | Included | Extra minutes |
|---|---|---|---|---|
| Front Desk | Starter | $79 / month | 100 minutes | $0.49 each |
| Busy Office | Professional | $199 / month | 500 minutes | $0.39 each |
| Pay As You Go | Custom | $29 / month | 30 minutes | $0.59 each |
These are the demo reseller's own retail prices, as an example. They aren't AssistCall's prices.
Limits
- Read-only. Any
POST,PATCHorDELETEreturns403 sandbox_read_only. Webhook endpoints can't be read either. - Per address. Sandbox credentials are shared, so limits count per IP address: 30 requests a minute and 2,000 a day, and 10 new tokens a minute. Reuse your token for its hour.
- Shared data. Everyone with sandbox credentials sees the same sample data.
Ready for your own data? Create a key in your dashboard.