Scoring

Validate and score a phone number

Parses the number, identifies line type (mobile, VoIP, premium rate, toll free) and carrier, and scores fraud risk.

get/v1/lookup/phone

Request

  • Base URL: https://www.layercall.com
  • URL: https://www.layercall.com/v1/lookup/phone
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

phonestring required

E.164 recommended. Without a leading +, pass country.

countrystring

ISO 3166-1 alpha-2, required for national-format numbers.

strictness'lenient' | 'balanced' | 'strict'

Shifts the allow/review/block thresholds. Signals and risk_score are unchanged.

Response

Result

phonestring required
risk_scoreinteger required

0 = clean, 100 = certain fraud.

verdict'allow' | 'review' | 'block' required

Recommended action. Thresholds move with strictness.

parse_status'ok' | 'country_required' | 'impossible' | 'invalid_pattern'

Distinguishes 'you omitted country' from 'this number is bad'.

cachedboolean
request_idstring
processing_time_secnumber
first_seenunknown
times_seeninteger
abuse_reportsinteger
billable_lookupsinteger

Example response

{
  "processing_time_sec": 0.116,
  "times_seen": 1,
  "billable_lookups": 1
}

Changes

No recorded changes to this operation across all 1 revision of this API.