Phone Number Validator - Apify Actor

A powerful Apify Actor for validating and parsing phone numbers from any country. Get instant validation results with detailed information including formatting options, number type classification, and metadata for phone numbers worldwide.

Features

• Global Coverage: Validate phone numbers from all countries/regions worldwide
• Multiple Formats: Output numbers in International, National, E164, and RFC3966 formats
• Number Type Detection: Identify Mobile, Fixed Line, Toll-Free, Premium Rate, VoIP, and more
• Detailed Validation: Get specific error messages for invalid numbers
• Flexible Input: Accept numbers with or without country codes
• Extension Support: Parse and preserve phone number extensions
• High Accuracy: Industry-standard validation algorithms

Input Schema

{
    "phoneNumbers": ["+1 650-253-0000", "+44 20 7183 8750"],
    "defaultRegion": "US"
}

Input Parameters

Parameter	Type	Required	Description
phoneNumbers	Array	Yes	Array of phone numbers to validate (supports single or multiple)
defaultRegion	String	No	ISO 3166-1 alpha-2 country code (default: "US")

Output

Single Number Validation

When validating a single phone number:

{
    "type": "single_validation",
    "input": "+1 650-253-0000",
    "success": true,
    "isValid": true,
    "isPossible": true,
    "countryCode": 1,
    "nationalNumber": "6502530000",
    "region": "US",
    "formatted": {
        "international": "+1 650-253-0000",
        "national": "(650) 253-0000",
        "e164": "+16502530000",
        "rfc3966": "tel:+1-650-253-0000"
    },
    "type": "FIXED_LINE_OR_MOBILE",
    "metadata": {
        "isValidForRegion": true,
        "canBeInternationallyDialled": true
    }
}

Output Attributes for Successful Validation

Attribute	Type	Description
type	String	Indicates validation type (single_validation or batch_validation)
input	String	The original phone number input provided
success	Boolean	Whether the parsing operation succeeded (not same as validation)
isValid	Boolean	Whether the phone number is valid according to the region's rules
isPossible	Boolean	Whether the phone number is possible based on length
countryCode	Number	The country calling code (e.g., 1 for US, 44 for UK)
nationalNumber	String	The national significant number without country code
region	String	ISO 3166-1 alpha-2 country code of the number
extension	String/null	Phone extension if present (e.g., "123" from "+1 650 253 0000 ext 123")
formatted	Object	Contains the number in various formats
formatted.international	String	International format (e.g., "+1 650-253-0000")
formatted.national	String	National format (e.g., "(650) 253-0000")
formatted.e164	String	E164 format (e.g., "+16502530000")
formatted.rfc3966	String	RFC 3966 format (e.g., "tel:+1-650-253-0000")
type	String	Number type classification (see Number Types section)
metadata	Object	Additional metadata about the number
metadata.isValidForRegion	Boolean	Whether the number is valid for its detected region
metadata.canBeInternationallyDialled	Boolean	Whether the number can be dialled internationally

Invalid Number

{
    "type": "single_validation",
    "input": "123",
    "success": true,
    "isValid": false,
    "isPossible": false,
    "validationError": "TOO_SHORT",
    "errorMessage": "The phone number is too short for the region"
}

Batch Validation Result

{
    "type": "batch_validation",
    "totalProcessed": 4,
    "summary": {
        "total": 4,
        "valid": 3,
        "possible": 3,
        "invalid": 1
    },
    "results": [
        // Individual validation results for each number
    ]
}

Number Types

The Actor identifies the following phone number types:

Type	Description
FIXED_LINE	Landline numbers
MOBILE	Mobile/cellular numbers
FIXED_LINE_OR_MOBILE	Could be either type
TOLL_FREE	Toll-free numbers (800, 888, etc.)
PREMIUM_RATE	Premium rate numbers
SHARED_COST	Shared cost numbers
VOIP	Voice over IP numbers
PERSONAL_NUMBER	Personal numbering services
PAGER	Pager numbers
UAN	Universal Access Numbers
VOICEMAIL	Voicemail access numbers
UNKNOWN	Type cannot be determined

Validation Errors

Error Code	Description	Example
TOO_SHORT	Number has too few digits	"123" in US
TOO_LONG	Number has too many digits	"12345678901234" in US
INVALID_COUNTRY_CODE	Country code not recognized	"+999 123456"
INVALID_LENGTH	Doesn't match expected patterns	"1234567" in UK
NOT_A_NUMBER	Not recognizable as phone number	"abc-defg"

Supported Regions

Supports all countries with assigned telephone country codes:

• Americas: US, CA, MX, BR, AR, CL, CO, PE, VE, etc.
• Europe: GB, DE, FR, IT, ES, CH, NL, BE, SE, NO, DK, PL, etc.
• Asia-Pacific: CN, JP, KR, IN, AU, NZ, SG, TH, MY, ID, PH, etc.
• Middle East & Africa: AE, SA, IL, EG, ZA, NG, KE, MA, etc.
• And 200+ more regions

Use Cases

• E-commerce: Validate customer phone numbers at checkout
• CRM Systems: Clean and standardize phone number databases
• Marketing: Verify phone numbers before SMS campaigns
• User Registration: Validate phone numbers during sign-up
• Data Migration: Format phone numbers consistently
• Lead Generation: Verify collected phone numbers
• Customer Support: Validate callback numbers

Security & Privacy

• No phone numbers are stored after processing
• Results are kept in your private Apify dataset
• Secure HTTPS API endpoints
• Actor runs in isolated Docker containers
• Compliant with data protection standards

Error Handling

The Actor handles errors gracefully:

{
    "success": false,
    "error": {
        "code": "PARSE_ERROR",
        "message": "Failed to parse phone number",
        "validationError": "NOT_A_NUMBER"
    }
}

Examples

Validate US Toll-Free Number

{
    "phoneNumbers": ["1-800-FLOWERS"],
    "defaultRegion": "US"
}

Validate International Mobile

{
    "phoneNumbers": ["+44 7700 900123"],
    "defaultRegion": "GB"
}

Batch Validation

{
    "phoneNumbers": [
        "+33 6 12 34 56 78",
        "0412 345 678",
        "+81-3-1234-5678"
    ],
    "defaultRegion": "US"
}