---
title: "Read the sandbox contract and the public test key."
method: GET
path: "/api/v1/sandbox"
tags: ["Sandbox"]
---

# Read the sandbox contract and the public test key.

`GET /api/v1/sandbox`

## Request

- Base URL: `https://deepsearch.app`
- URL: `https://deepsearch.app/api/v1/sandbox`
- Auth: none required

Describes the test mode: the published key (`dsk_test_deepsearch`), the operations that have fixtures, the exact events each fixture emits, and what the sandbox does not simulate. Everything here works without an account.

## Response `200`

The sandbox contract.

- SandboxContract
  - `object` 'sandbox', required
  - `description` string
  - `how_it_works` string[]
  - `public_key` 'dsk_test_deepsearch', required
  - `key_prefix` 'dsk_test_'
  - `body_flag` 'sandbox'
  - `response_header` 'X-DeepSearch-Sandbox'
  - `base_url` string, uri
  - `operations` object[], required: Each supported operation, with the exact fixture events it returns.
    - `operation` 'search' | 'dossier' | 'chat' | 'entity_search' | 'entity_dossier' | 'reverse_image' | 'vin', required
    - `path` string, uri, required
    - `events` StreamEvent[], required (unresolved $ref)
  - `batch_path` string, uri
  - `fixture_subject` string
  - `metered` unknown, required
  - `rate_limit` object
  - `limitations` string[]
  - `example` string
  - `docs_url` string, uri
  - `signup_url` string, uri

---

[API](https://skmtc.dev/deepsearch/apis/deepsearch-api.md) · [All operations](https://skmtc.dev/deepsearch/apis/deepsearch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/deepsearch/apis/deepsearch-api/revisions/85fc8e2576a3?raw)