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
}