> For the complete documentation index, see [llms.txt](https://api-docs.espysys.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-docs.espysys.com/phone-verification-real-phone/search-response-schema.md).

# Search Response Schema

Explanation of Key Fields

* **criteria**: Contains the phone number used in the verification query.
* **type**: Indicates the type of lookup.
* **status**: Shows the completion status of the request.
* **verifier**: Nested object providing critical information:
  * **finalClassification**: Specifies if the phone number is associated with a real person.
  * **score**: The AI-generated confidence score for the classification, with values between 0 and 1.

```
{
  "type": "object",
  "properties": {
    "criteria": {
      "type": "string",
      "description": "The phone number that was searched, including the country code."
    },
    "type": {
      "type": "string",
      "description": "The type of lookup performed, e.g., 'real_phone'."
    },
    "status": {
      "type": "string",
      "description": "The current status of the verification request, e.g., 'finished'."
    },
    "verifier": {
      "type": "object",
      "properties": {
        "finalClassification": {
          "type": "string",
          "description": "Classification result indicating if the phone belongs to a 'Real Person' or not."
        },
        "score": {
          "type": "number",
          "format": "float",
          "description": "A confidence score indicating the likelihood of the classification being accurate."
        }
      },
      "required": ["finalClassification", "score"],
      "description": "The verification details, including classification and confidence score."
    }
  },
  "required": ["criteria", "type", "status", "verifier"],
  "additionalProperties": false
}

```