Skip to main content
The sandbox command manages sandbox testers used for testing in-app purchases and subscriptions.

Usage

asc sandbox <subcommand> [flags]

Subcommands

List sandbox testers

asc sandbox list
asc sandbox list --output table

Get sandbox tester

asc sandbox get --tester-id TESTER_ID

Create sandbox tester

asc sandbox create \
  --email tester@example.com \
  --first-name John \
  --last-name Doe \
  --territory US

Update sandbox tester

asc sandbox update --tester-id TESTER_ID --first-name Jane

Delete sandbox tester

asc sandbox delete --tester-id TESTER_ID

Create flags

--email
string
required
Email address for the sandbox testerMust be unique and not used for any Apple ID.
--first-name
string
required
First name of the tester
--last-name
string
required
Last name of the tester
--territory
string
required
Two-letter territory code (e.g., US, GB, JP)

List flags

--output
string
Output format: json, table, or markdown
--limit
number
Maximum number of results
--paginate
boolean
Fetch all pages automatically

Example workflows

Create multiple sandbox testers

for i in {1..5}; do
  asc sandbox create \
    --email "tester$i@example.com" \
    --first-name "Tester" \
    --last-name "$i" \
    --territory US
done

List all testers

asc sandbox list --output table --paginate

Delete a tester

asc sandbox delete --tester-id TESTER_ID
Sandbox testers are used for testing in-app purchases in development and TestFlight builds. They do not incur real charges.

IAP command

Manage in-app purchases

Subscriptions command

Manage subscriptions