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 json { "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: json { "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 json { "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 json { "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: json { "success": false, "error": { "code": "PARSE_ERROR", "message": "Failed to parse phone number", "validationError": "NOT_A_NUMBER" } } ## Examples ### Validate US Toll-Free Number json { "phoneNumbers": ["1-800-FLOWERS"], "defaultRegion": "US" } ### Validate International Mobile json { "phoneNumbers": ["+44 7700 900123"], "defaultRegion": "GB" } ### Batch Validation json { "phoneNumbers": [ "+33 6 12 34 56 78", "0412 345 678", "+81-3-1234-5678" ], "defaultRegion": "US" }