Phone Number Risk Scoring avatar

Phone Number Risk Scoring

Pricing

$2.20 / 1,000 results

Go to Apify Store
Phone Number Risk Scoring

Phone Number Risk Scoring

Validate and score phone numbers. Detects disposable phone numbers, validates syntax, assesses operational likelihood, and identifies carrier information for enhanced fraud detection.

Pricing

$2.20 / 1,000 results

Rating

0.0

(0)

Developer

Greip

Greip

Maintained by Community

Actor stats

0

Bookmarked

16

Total users

1

Monthly active users

4 days ago

Last modified

Features

Limited permissions

Share

Greip's Phone Number Scoring

A robust Apify Actor that validates and analyzes phone numbers using the Greip Phone Number Scoring API (v2). This tool helps identify disposable, temporary, and VoIP phone numbers to enhance fraud detection and improve data quality.

Features

  • Phone Number Validation: Comprehensive syntax validation and operational assessment
  • Disposable Number Detection: Identify temporary and disposable phone numbers
  • VoIP Service Detection: Detect numbers associated with VoIP services
  • Carrier Information: Get carrier details for phone numbers
  • Structured Output: Clean, well-formatted JSON results stored in datasets

API

  • Base URL: https://v2.greipapi.com
  • Endpoint: GET /score/phone/{phone} (phone is URL-encoded in the path)
  • Query parameters: country_code (required), user_id (optional), source=Apify, mode (live or test)
  • Authentication: Authorization: Bearer header using the GREIP_API_KEY environment variable (never pass the key as a query parameter)

Input Parameters

ParameterTypeRequiredDescription
phonestringYesPhone number to validate and analyze
countryCodestringYesISO 3166-1 alpha-2 country code (e.g., "US")
userIDstringNoOptional user identifier for tracking
modestringNolive (default) or test (fake data, no quota)

Output Format

The Actor outputs detailed information about each phone number:

{
"phone": "+905343192830",
"countryCode": "TR",
"isValid": true,
"disposable": false,
"isBlacklisted": false,
"carrier": "Turkcell",
"riskLevel": "low",
"recommendation": "accept",
"reasons": [],
"reason": null,
"timestamp": "2026-11-15T12:00:00.000Z"
}

Output Field Descriptions

  • isValid: Whether the phone number is considered safe and valid
  • disposable: Whether the number is disposable, temporary, or VoIP
  • isBlacklisted: Whether the number matched your account custom rules or blocklists
  • reason: Semicolon-joined summary of reasons, or null if none
  • reasons: Array of human-readable risk explanations from Greip v2
  • carrier: Carrier or service provider name
  • riskLevel: Greip risk level assessment
  • recommendation: string | null from Greip; documented values are accept, review, and reject (other strings are passed through unchanged; non-strings become null)
  • phone, countryCode, timestamp: Identity and processing metadata

On failure, the dataset includes status: "error" and an error message (no API key or personal data in the message).

Use Cases

This Actor is perfect for:

  • Fraud Prevention: Detect temporary and disposable phone numbers often used in fraudulent activities
  • User Registration: Validate phone numbers during user sign-up to ensure legitimate contact information
  • SMS Marketing: Filter out invalid and VoIP numbers to improve campaign effectiveness
  • Multi-Account Detection: Identify users attempting to create multiple accounts with disposable numbers
  • Data Quality: Ensure phone number databases contain only valid, operational numbers
  • Customer Verification: Verify the legitimacy of customer-provided phone numbers

Phone Number Formats Supported

The API accepts phone numbers in various formats:

  • +905343192830 (International format with + sign)
  • 00905343192830 (International format with 00 prefix)
  • 905343192830 (Without international prefix)
  • 5343192830 (Local format)

Development

npm install
npm run build
npm run lint
npm test

Set GREIP_API_KEY in the Actor environment on Apify. For local runs, use Apify CLI storage or apify run with input under storage/key_value_stores/default/INPUT.json.

Your feedback

We're always working on improving the performance of our Actors. If you have any technical feedback for phone number scoring or found a bug, please create an issue in the Issues tab.