---
title: "Discovery Query"
method: POST
path: "/v2/discovery/query"
tags: ["discovery-v2"]
---

# Discovery Query

`POST /v2/discovery/query`

## Headers

- `authorization` string, nullable
- `X-Tenant` string, nullable

## Request body

- DiscoveryQueryRequest
  - `buy_box` string, required
  - `draft` DiscoveryDraft
    - `markets` string[], required
    - `must` Rule[]
      - `field` string, required
      - `op` string, required
      - `value` unknown, required
      - `unknown` 'exclude' | 'review', nullable
    - `preferred` PreferredRule[]
      - `field` string, required
      - `op` string, required
      - `value` unknown, required
      - `weight` number, required
    - `verdict_cutoffs` Cutoffs, required
      - `pursue` number, required
      - `monitor` number, required
  - `limit` integer
  - `cursor` string, nullable

## Response `200`

Successful Response

- DiscoveryQueryResponse
  - `market` string, required
  - `market_id` string, uuid, required
  - `vintage_id` string, uuid, required
  - `query_hash` string, required
  - `applied_spec` DiscoveryDraft, required
    - `markets` string[], required
    - `must` Rule[]
      - `field` string, required
      - `op` string, required
      - `value` unknown, required
      - `unknown` 'exclude' | 'review', nullable
    - `preferred` PreferredRule[]
      - `field` string, required
      - `op` string, required
      - `value` unknown, required
      - `weight` number, required
    - `verdict_cutoffs` Cutoffs, required
      - `pursue` number, required
      - `monitor` number, required
  - `denominator` integer, required
  - `preference_weight_total` number, required
  - `eligible_total` integer, required
  - `results` DiscoveryResult[], required
    - `parcel_key` string, required
    - `apn` string, nullable, required
    - `address` string, nullable, required
    - `lat` number, nullable, required
    - `lon` number, nullable, required
    - `acres` number, nullable, required
    - `developable_acres` number, nullable, required
    - `geometry` object, nullable, required
    - `bbox` number[], nullable, required
    - `facts` object, required
    - `provenance` object, required
    - `score` number, required
    - `verdict` 'PURSUE' | 'MONITOR' | 'HOLD', required
    - `review_required` boolean, required
    - `unknowns` string[], required
    - `score_breakdown` ScoreBreakdown, required
      - `must` MustEvidence[], required
        - `field` string, required
        - `value` unknown, required
        - `status` 'pass' | 'fail' | 'unknown', required
      - `preferred` PreferredEvidence[], required
        - `field` string, required
        - `value` unknown, required
        - `weight` number, required
        - `contribution` number, required
  - `next_cursor` string, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mireye/apis/mireye-scout-api.md) · [All operations](https://skmtc.net/mireye/apis/mireye-scout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mireye/mireye-scout-api/revisions/c80d2b343f16/schema)