Client for 'GenderAPI.io' Phone Number Validation and Formatter API

Provides an interface to the 'GenderAPI.io' Phone Number Validation & Formatter API (< https://www.genderapi.io>) for validating international phone numbers, detecting number type (mobile, landline, Voice over Internet Protocol (VoIP)), retrieving region and country metadata, and formatting numbers to E.164 or national format. Designed to simplify integration into R workflows for data validation, Customer Relationship Management (CRM) data cleaning, and analytics tasks. Full documentation is available at < https://www.genderapi.io/docs-phone-validation-formatter-api>.

📞 Phone Number Validation & Formatter API (R SDK)

The PhoneValidator R package is the official client for the GenderAPI Phone Number Validation & Formatter API, enabling you to validate and format phone numbers from over 240 countries worldwide.

Whether your users provide phone numbers in various formats (e.g., 12128675309, +1 212 867 5309, 001–212–867–5309), this package intelligently detects, validates, and converts the input into a standardized E.164 format (e.g., +12128675309).

✅ Features

• Converts phone numbers to E.164 format
• Validates if a number is valid and structurally possible
• Detects number type: mobile, landline, VoIP, etc.
• Identifies region/city based on area code
• Includes country-level metadata (e.g., ISO code, time zone)
• Built with R and powered by GenderAPI.io

📦 Installation

Since this package is not yet on CRAN, you can install it directly from GitHub:

# Install devtools if not already installed
install.packages("devtools")

# Install the PhoneValidator package
devtools::install_github("GenderAPI/PhoneValidator-R")

🚀 Usage

library(PhoneValidator)

result <- validate(
  api_key = "YOUR_API_KEY",
  number = "+1 212 867 5309",
  address = "US"  # Optional, improves parsing of local numbers
)

print(result)

🧾 Input Parameters

validate(api_key = "YOUR_API_KEY", number = "12128675309", address = "US")

📤 API Response Example

{
  "status": true,
  "remaining_credits": 15709,
  "expires": 0,
  "duration": "18ms",
  "regionCode": "US",
  "countryCode": 1,
  "country": "United States",
  "national": "(212) 867–5309",
  "international": "+1 212-867-5309",
  "e164": "+12128675309",
  "isValid": true,
  "isPossible": true,
  "numberType": "FIXED_LINE_OR_MOBILE",
  "nationalSignificantNumber": "12128675309",
  "rawInput": "+1 212 867 5309",
  "isGeographical": true,
  "areaCode": "212",
  "location": "New York City (Manhattan)"
}

📚 Response Fields

🔢 Number Type Values

ℹ️ More Information

• Supports 240+ countries and territories
• Auto-detects landline vs. mobile numbers
• Useful for CRM, form validation, user profiling
• Full API documentation: GenderAPI Phone Validation Docs

📝 License

MIT License © GenderAPI