Skip to main content

Check Phone Number

Submit a phone number for validation and fraud detection.

Submit Phone Check​

Create a new phone number check request.

Endpoint​

POST /api/v1/checkers/phone/

Request Body​

{
  "value": "+88002000600"
}

Request Example​

curl -X 'POST' \
  'https://app.cyberyozh.com/api/v1/checkers/phone/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "+12025550123"
  }'

Request Fields​

FieldTypeRequiredDescription
valuestringYesPhone number in international format (E.164)

Phone Number Format​

Phone numbers should be provided in international format with country code:

  • ✅ Correct: +12025550123, +442071234567, +88002000600
  • ❌ Incorrect: 2025550123, 02071234567, 8002000600

Response (201)​

{
  "id": "9adb5486-0742-4c6f-a372-d434649aa698"
}

The response contains a unique identifier that can be used to retrieve the check results.

Response Fields​

FieldTypeDescription
idstringid report

Notes​

  • Each phone check request consumes credits from your balance
  • Check results are stored and can be retrieved multiple times using the same ID
  • Invalid phone number formats will return an error
  • The same phone number can be checked multiple times (each check is billed separately)