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

# Sandbox

# sandbox

> Manage sandbox testers for testing in-app purchases and subscriptions

The `sandbox` command manages sandbox testers used for testing in-app purchases and subscriptions.

## Usage

```bash theme={null} theme={null}
asc sandbox <subcommand> [flags]
```

## Subcommands

### List sandbox testers

```bash theme={null} theme={null}
asc sandbox list
asc sandbox list --output table
```

### Get sandbox tester

```bash theme={null} theme={null}
asc sandbox view --id "SANDBOX_TESTER_ID"
asc sandbox view --email "tester@example.com"
```

### Update sandbox tester

```bash theme={null} theme={null}
asc sandbox update --id "SANDBOX_TESTER_ID" --territory USA
asc sandbox update --email "tester@example.com" --interrupt-purchases true
```

### Clear sandbox tester history

```bash theme={null} theme={null}
asc sandbox clear-history --id "SANDBOX_TESTER_ID" --confirm
```

## List flags

<ParamField path="--output" type="string">
  Output format: `json`, `table`, or `markdown`
</ParamField>

<ParamField path="--limit" type="number">
  Maximum number of results
</ParamField>

<ParamField path="--paginate" type="boolean">
  Fetch all pages automatically
</ParamField>

## View and update flags

<ParamField path="--id" type="string">
  Sandbox tester ID
</ParamField>

<ParamField path="--email" type="string">
  Tester email address
</ParamField>

<ParamField path="--territory" type="string">
  App Store territory code (for updates), such as `USA` or `JPN`
</ParamField>

<ParamField path="--interrupt-purchases" type="boolean">
  Interrupt purchases during testing
</ParamField>

## Example workflows

### Review sandbox testers

```bash theme={null} theme={null}
asc sandbox list --output table --paginate
asc sandbox view --email "tester@example.com"
```

### Update a tester

```bash theme={null} theme={null}
asc sandbox update --id "SANDBOX_TESTER_ID" --territory USA
```

### Reset purchase history

```bash theme={null} theme={null}
asc sandbox clear-history --id "SANDBOX_TESTER_ID" --confirm
```

<Note>
  Sandbox testers are used for testing in-app purchases in development and TestFlight builds. They do not incur real charges.
</Note>

## Related

<CardGroup cols={2}>
  <Card title="IAP command" icon="dollar-sign" href="/commands/iap">
    Manage in-app purchases
  </Card>

  <Card title="Subscriptions command" icon="repeat" href="/commands/subscriptions">
    Manage subscriptions
  </Card>
</CardGroup>