Pricing

Rating

Developer

Actor stats

Categories

Share

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

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

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:

Validation Errors

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"
}