Understanding Verification Results

Learn how to interpret the searchState.status field in verification responses.

Search Status Values

The searchState.status field indicates the verification result:

found

Exact match found in the document. The citation is verified.

{
  "searchState": {
    "status": "found"
  }
}

partial_text_found

Some of the citation text was found, but not an exact match. This often occurs when:

• The LLM paraphrased the source text
• Minor word differences exist
• The citation is a close approximation

{
  "searchState": {
    "status": "partial_text_found"
  }
}

found_anchor_text_only

The short value/anchorText was found, but the full phrase was not. This indicates the key information exists but the surrounding context differs.

{
  "searchState": {
    "status": "found_anchor_text_only"
  }
}

found_on_other_page

Citation found, but on a different page than specified. The content exists but the page reference was incorrect.

{
  "searchState": {
    "status": "found_on_other_page",
    "expectedPage": 1,
    "actualPage": 3
  }
}

found_on_other_line

Citation found on the correct page, but on a different line than expected.

{
  "searchState": {
    "status": "found_on_other_line",
    "expectedLineIds": [5, 6],
    "actualLineIds": [12, 13]
  }
}

first_word_found

Only the first word of the phrase was found. This may indicate a partial match or incorrect citation.

not_found

Citation could not be verified - text not found in document. This may indicate:

• A hallucination by the LLM
• Incorrect attachment ID
• Citation from a different source

{
  "searchState": {
    "status": "not_found"
  }
}

pending

Verification is still in progress. Wait and retry.

{
  "searchState": {
    "status": "pending"
  }
}

Verification Image

When a citation is found, the verificationImageBase64 field contains a cropped image of the source document showing the matched text. This provides visual proof for users.

Format

The image is base64-encoded and includes the data URI prefix:

data:image/avif;base64,AAAAIGZ0eXBhdmlm...

Supported Formats

Specify the format in the verification request with outputImageFormat.

Status Grouping for UI

When displaying citations, group statuses by user impact: