Skip to content

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.

On this page

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.

Already have an AssistCall account? You don't need the sandbox: create your own key on the Developers page with the Read-only preset and try everything against your own data (Quickstart).

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)

ClientStatusPackage
Demo DentalActiveFront Desk
Demo Heating & Air
AI Employee Sam, 2 calls, 1 booking, 1 message
ActiveBusy Office
Demo Law Group
no AI Employee yet
Setting upPay As You Go
PackageBased onPriceIncludedExtra minutes
Front DeskStarter$79 / month100 minutes$0.49 each
Busy OfficeProfessional$199 / month500 minutes$0.39 each
Pay As You GoCustom$29 / month30 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, PATCH or DELETE returns 403 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.

Try "token", "webhook signature", "rate limit" or "custom domain".