---
title: "Query (JSON)"
method: GET
path: "/sandbox/request"
tags: ["Sandbox"]
---

# Query (JSON)

`GET /sandbox/request`

Returns a JSON array of module results for the given query.
Results are deterministic — the same query always returns the same
modules and values.

## Query parameters

- `query` string, required
- `type` 'email' | 'phone' | 'username' | 'name' | 'wallet', required
- `timeout` number
- `premium` boolean
- `exact_match` boolean
- `info_signals` boolean

## Response `200`

Array of module results.

- ModuleResult[]
  - `module` string, required — Unique platform slug. The special slug `"breach"` aggregates data-breach records.
  - `category` Category, required
    - `type` string, required
    - `name` string, required — Category label.
    - `description` string, required
  - `status` 'found', required — Always `"found"` in sandbox responses.
  - `query` string, required — The original query value echoed back.
  - `from` string, required — Human-readable description of the query source.
  - `reliable_source` boolean, required
  - `data` object, required — Internal metadata.
    - `data` boolean
  - `spec_format` SpecEntry[], required — Structured typed data. One entry per result record. Most modules have one entry. The `breach` module and `name`-type modules can have many (up to 50 for `name`).
    - `registered` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `breach` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `name` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `first_name` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `last_name` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `username` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `bio` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `picture_url` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `location` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `profile_url` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `gender` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `age` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `creation_date` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `last_seen` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `verified` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `premium` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `private` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `phone_hint` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `website` TypedField — A typed wrapper around a single spec value.
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required — Runtime type of `value`.
      - `proper_key` string, required — Human-readable label derived from the field name.
      - `value` union, required — The field value. Type matches the `type` field.
        - string
        - number
        - boolean
    - `platform_variables` PlatformVariable[]
      - `key` string, required — Snake_case identifier.
      - `proper_key` string, required — Human-readable label.
      - `value` union, required — The value. Type matches the `type` field.
        - string
        - number
        - boolean
      - `type` 'str' | 'int' | 'float' | 'bool' | 'datetime' | 'list' | 'dict' | 'null', required
  - `front_schemas` FrontSchema[], required — Display-ready data, parallel to `spec_format`. Same length.
    - `module` string, required — Display name for this record (platform name or person's name).
    - `kind` 'user' | 'aggregator', required — `"user"` for regular profiles. `"aggregator"` for the breach module (multiple breaches under one entry).
    - `image` string, nullable — Profile or logo image URL.
    - `body` object, required — Key-value pairs ready for display. Values are primitives or arrays of strings.
    - `tags` Tag[], required — Badge-style labels. Each tag has a `tag` string and an optional `url`.
      - `tag` string, required
      - `url` string, nullable
    - `timeline` Timeline — Activity timeline for the profile or breach event.
      - `last_seen` boolean
      - `registered` boolean
      - `last_seen_date` string, date-time, nullable
      - `registered_date` string, date-time, nullable
      - `groups` object — Keyed by a group slug. Each value defines the visual style and label for timeline events.
      - `group_items` object — Keyed by group slug. Each value is an array of timeline events.
      - `group_years` object — Keyed by group slug → year → event count.
    - `map` MapMarker[], nullable — Map markers. Present when the platform returned location data. `null` or absent when there is no location data.
      - `type` 'lat_lng', required
      - `lat_lng` number[], required — [latitude, longitude]
      - `icon` MapIcon, required
        - `awesome_marker` boolean, required
        - `location_type` string, required — FontAwesome icon name.
        - `prefix` 'fa', required
        - `icon_color` string, required — Foreground colour of the icon.
        - `marker_color` 'red' | 'darkred' | 'orange' | 'green' | 'darkgreen' | 'blue' | 'purple' | 'darkpurple' | 'cadetblue', required — Background colour of the marker pin.
        - `extra_classes` string, required
      - `popup` MapPopup, required — Content shown when the marker is clicked.
        - `title` string, nullable
        - `subtitle` string, nullable
        - `date` string, date-time, nullable
        - `address` string, nullable
        - `comment` string, nullable
        - `image` string, nullable
        - `url` string, nullable
      - `circle` string, nullable, required — Optional circle overlay. `null` in most cases.

## Other responses

- `400` — Valid key but insufficient credits or unpermitted role.
- `401` — Missing or invalid API key.

---

[API](https://skmtc.net/osint/apis/v2-api.md) · [All operations](https://skmtc.net/osint/apis/v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/osint/v2-api/versions/cd5fec0d90bd/schema)