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

# Ground response format

> Target status, match methods, and preview artifacts

```json theme={"dark"}
{
  "result_type": "ground",
  "targets": [
    {
      "id": "total",
      "status": "found",
      "matches": [
        {
          "rank": 1,
          "matched_text": "1,200.50",
          "match_method": "normalized",
          "confidence": null,
          "location": { "kind": "text_span", "page": 1, "char_start": 120, "char_end": 128 },
          "cropped_image_url": null
        }
      ]
    }
  ],
  "units": 1
}
```

* **`status`** — `found`, `not_found`, or `failed` per target
* **`match_method`** — `exact`, `normalized`, or `semantic`
* **`confidence`** — `null` for exact/normalized; set only for semantic matches
* **`cropped_image_url`** — present when previews were requested and a visual region exists

Related artifact routes (same auth):

* Ground crops
* Ground transcripts
* Converted PDF
* Spreadsheet cell maps