ReachReady
Back to Home

Help Center & Guides

Everything you need to know about validating phone numbers, bulk CSV processing, result columns, and API integration.

Single Checks

Verify individual numbers directly in the dashboard with real-time dial-code auto detection.

Bulk Uploads

Validate 500,000+ row spreadsheets in your browser. Clean outputs categorized into Keep, Review, and Drop.

REST API v1

Generate secret keys to automate phone verification inside your CRM, signup forms, or backend workers.

Understanding Verdicts

SMS OK

Reachable Mobile Number

Assigned to a wireless carrier, actively registered, and capable of receiving SMS messages and voice calls. Safe for text campaigns.

Call OK

Reachable Landline or Voice Line

Valid fixed-line or corporate trunk. Cannot receive standard SMS text messages, but safe for voice outreach and sales dialers.

Review

VoIP, Virtual, or Unknown

Virtual numbers (Skype, Google Voice, Twilio), disposable lines, or unallocated ranges. High risk of non-delivery or fraud.

Do Not Contact

Invalid, Disconnected, or Malformed

Number violates numbering plan rules, is inactive, or missing digits. Filter these out immediately to protect your sender reputation.

Data Dictionary

Result Columns Reference

When you export a cleaned bulk CSV or make a call to our REST API, ReachReady preserves all your original columns and appends the following enriched fields:

Export Column HeaderData TypeExampleMeaning & Outreach Usage
reachready_e164string (E.164)+14155552671
Number
The universally normalized international phone number adhering to the ITU-T E.164 standard (+ followed by country calling code and subscriber number with all local delimiters removed). Perfect for direct ingestion into CRM, dialers, and SMS gateways.
reachready_verdictenumsms_ok
Verdict
The immediate routing outcome recommended by ReachReady. sms_ok = verified mobile line safe for SMS & calling; call_ok = valid fixed line / landline (voice outreach only); review = VoIP, virtual, or ambiguous line; do_not_contact = invalid, unallocated, or blacklisted.
reachready_statusenumvalid
Status
High-level status according to authoritative global telecom registries. Returns "valid" if allocated and structurally compliant, "invalid" if non-existent or failing plan constraints, or "unknown" if missing country context.
reachready_reasonstring | nullnull
Reason
Granular diagnostic code when a number cannot be approved for outreach. Common reasons include "unallocated_range", "invalid_length", "toll_free_unsupported", "emergency_service", or "no_country_context". Null for fully valid numbers.
reachready_national_formatstring(415) 555-2671
National
The phone number formatted for domestic dialing within its destination country, including national trunk prefixes where applicable.
reachready_international_formatstring+1 415-555-2671
International
Human-readable international format with standardized spacing and country code, ideal for clean presentation on outbound sales dashboards.
reachready_country_namestringUnited States
Country
Full canonical English country or territory name resolved from the international calling code and national numbering block.
reachready_country_iso2string (ISO-2)US
ISO
Standardized two-letter ISO 3166-1 alpha-2 country code, essential for lead routing, compliance filtering, and regional segmentation.
reachready_dial_codestring+1
Dial Code
The international subscriber dialing prefix with leading plus sign (+1 for US/Canada, +44 for UK, +91 for India, +966 for Saudi Arabia, etc.).
reachready_regionstring | nullCalifornia
Region
Geographical administrative region, state, or metropolitan area mapped to the telephone area code or exchange.
reachready_timezonestring | nullAmerica/Los_Angeles
Timezone
The canonical IANA timezone database name. Critical for TCPA compliance to ensure automated messages and phone calls only occur during lawful domestic daylight hours.
reachready_utc_offsetstring | null-07:00
UTC Offset
The active Coordinated Universal Time (UTC) offset taking into account daylight saving time adjustments.
reachready_line_typeenummobile
Line Type
Telecom device classification. Distinguishes mobile handsets (SMS-capable), landline (fixed voice lines), voip (virtual cloud numbers), toll_free (inbound only), or premium_rate.
reachready_carrierstring | nullAT&T
Carrier
The telecommunications network operator or wireless provider allocated to this number block by national regulatory bodies.
reachready_valid_numberbooleantrue
Valid Number
Boolean flag indicating whether the phone number is fully valid according to national numbering authority rules and active allocation blocks.
reachready_valid_lengthbooleantrue
Length Check
Boolean verification indicating whether the digit length matches possible number structures for the detected country.

Need additional technical assistance?

Our engineering team is available to help you resolve edge cases, test custom dial codes, or debug batch payloads.

hello@reachready.io →