Get Check Results

Retrieve phone number validation results and fraud reports.

Get All Checks

Retrieve all phone checks with pagination support.

Endpoint

GET /api/v1/checkers/phone/

Query Parameters

Parameter	Type	Required	Description
page	integer	No	Page number
page_size	integer	No	Results per page

Request

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/checkers/phone/?page=1&page_size=20' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here'

Response (200)

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "9adb5486-0742-4c6f-a372-d434649aa698",
      "status": "completed",
      "created_at": "2026-03-07T12:00:00Z",
      "report": {
        "mcc": "310",
        "mnc": "410",
        "VOIP": false,
        "city": "Washington",
        "name": "AT&T Mobility",
        "risky": false,
        "valid": true,
        "active": true,
        "leaked": false,
        "region": "District of Columbia",
        "carrier": "AT&T",
        "country": "United States",
        "message": "Valid phone number.",
        "prepaid": false,
        "spammer": false,
        "success": true,
        "timezone": "America/New_York",
        "zip_code": "20001",
        "formatted": "+1 202 555 0123",
        "line_type": "Mobile",
        "sms_email": "2025550123@txt.att.net",
        "request_id": "UuYUlmvcjn",
        "sms_domain": "txt.att.net",
        "do_not_call": false,
        "fraud_score": 15,
        "dialing_code": 1,
        "local_format": "(202) 555-0123",
        "recent_abuse": false,
        "active_status": "Active",
        "user_activity": "Medium",
        "accurate_country_code": true,
        "associated_email_addresses": {
          "emails": [],
          "status": "No associated emails found."
        }
      }
    }
  ]
}

Get Specific Check

Retrieve results for a specific phone check by ID.

Endpoint

GET /api/v1/checkers/phone/{id}/

Path Parameters

Parameter	Type	Required	Description
id	string (uuid)	Yes	Check identifier

Request

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/checkers/phone/9adb5486-0742-4c6f-a372-d434649aa698/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here'

Response (200)

{
  "id": "9adb5486-0742-4c6f-a372-d434649aa698",
  "status": "completed",
  "created_at": "2026-03-07T12:00:00Z",
  "report": {
    "mcc": "310",
    "mnc": "410",
    "VOIP": false,
    "city": "Washington",
    "name": "AT&T Mobility",
    "risky": false,
    "valid": true,
    "active": true,
    "leaked": false,
    "region": "District of Columbia",
    "carrier": "AT&T",
    "country": "United States",
    "message": "Valid phone number.",
    "prepaid": false,
    "spammer": false,
    "success": true,
    "timezone": "America/New_York",
    "zip_code": "20001",
    "formatted": "+1 202 555 0123",
    "line_type": "Mobile",
    "sms_email": "2025550123@txt.att.net",
    "request_id": "UuYUlmvcjn",
    "sms_domain": "txt.att.net",
    "do_not_call": false,
    "fraud_score": 15,
    "dialing_code": 1,
    "local_format": "(202) 555-0123",
    "recent_abuse": false,
    "active_status": "Active",
    "user_activity": "Medium",
    "accurate_country_code": true,
    "associated_email_addresses": {
      "emails": [],
      "status": "No associated emails found."
    }
  }
}

Response Fields

Top-Level Fields

Field	Type	Description
id	string	Check identifier
status	string	Check status (completed, processing, failed)
created_at	string	Timestamp when check was created
report	object	Detailed validation report

Report Fields

Basic Information

Field	Type	Description
valid	boolean	Whether the phone number is valid
active	boolean	Whether the number is currently active
success	boolean	Whether the check was successful
message	string	Status message
formatted	string	International format
local_format	string	Local format with country conventions
country	string	Country name
dialing_code	integer	Country dialing code

Carrier Information

Field	Type	Description
carrier	string	Carrier name
name	string	Full carrier name
line_type	string	Type (Mobile, Landline, VOIP, Unknown)
mcc	string	Mobile Country Code
mnc	string	Mobile Network Code
prepaid	boolean	Whether it's a prepaid number

Geographic Information

Field	Type	Description
city	string	City name
region	string	State/province
zip_code	string	Postal code
timezone	string	IANA timezone identifier
accurate_country_code	boolean	Whether country detection is accurate

Fraud & Risk Assessment

Field	Type	Description
fraud_score	integer	Fraud score (0-100, higher = riskier)
risky	boolean	Whether number is flagged as risky
VOIP	boolean	Whether it's a VOIP number
spammer	boolean	Known spammer
leaked	boolean	Found in data breaches
recent_abuse	boolean	Recently used for abuse
do_not_call	boolean	On do-not-call registry
user_activity	string	Activity level assessment

Additional Features

Field	Type	Description
active_status	string	Detailed active status
sms_email	string	SMS-to-email gateway address
sms_domain	string	Carrier's SMS gateway domain
associated_email_addresses	object	Linked email addresses (if available)

Fraud Score Interpretation

Score Range	Risk Level	Description
0-25	Low Risk	Number appears legitimate
26-50	Medium Risk	Some risk indicators present
51-75	High Risk	Multiple risk factors detected
76-100	Very High Risk	Strong indicators of fraud

Status Values

Value	Description
new	Just created. Not yet processed
ready_to_perform_audit	Ready to run audit
processing	Waiting report
completed	Finished (success or failed, details in report)

Notes

• Check results are stored permanently and can be retrieved multiple times
• Processing typically completes in 1-3 seconds
• Invalid phone numbers will return valid: false with minimal data
• Some fields may show "N/A" or null if data is unavailable