Data Intelligence

Check a phone number

POSThttps://osintintel.com/api/phone-number

Validates the number and returns country, carrier and line type, such as mobile, landline or VoIP.

Authenticate with your API key in the Authorization: Bearer header. Authentication

Body parameters

  • phonestringrequired

    The phone number in international format, with the + prefix.

  • forcebooleanoptional

    Skip the cache and run a fresh analysis. Defaults to false.

Response

200 with success, cached and the report. The example on the right is abridged with dummy values; live responses contain more fields, and any field can be null when a source had no answer.

Errors

  • 400

    The body is not valid JSON, or the value is missing or malformed.

  • 401

    The API key is missing or invalid.

  • 422

    The target could not be analysed, for example a website that is down or timed out.

  • 429

    Rate limit reached. See the Retry-After header.

Request
curl -X POST "https://osintintel.com/api/phone-number" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"+447700900123"}'
Response
{
  "success": true,
  "cached": false,
  "report": {
    "phone": "+447700900123",
    "status": "COMPLETE",
    "countryCode": "GB",
    "numberType": "VOIP",
    "isValid": true,
    "carrier": "Example Telecom",
    "internationalFormat": "+44 7700 900123",
    "riskFactors": [
      { "factor": "VoIP number", "points": 15 }
    ]
  }
}