Bulk HLR Lookup

Overview

What it does: Performs a real-time HLR (Home Location Register) lookup on your HubSpot contacts to verify if phone numbers are active, reachable, and identifies their line type (Mobile, Landline, etc.) and carrier.
When to use it: When you have thousands of contacts that need checking before a campaign launch, inherited a database that's never been cleaned, or need to audit your entire CRM's phone data quality at once.
Business value: Stop calling dead numbers and stop sending SMS to landlines. Get detailed network intelligence to segment your lists by carrier or line type. Skip months of gradual workflow-based HLR lookups.

How It Works

    Discovery: We assess your database size and requirements.
    Processing: We scan your contacts using direct HLR network queries.
    Enrichment: Your HubSpot contacts are updated with real-time network data.
    Reporting: You get a summary of your database health.

What Gets Updated

For each contact checked, the following properties are set:
  • hlr_status: The live network status.
  • LIVE: Active and reachable.
  • DEAD: Disconnected or invalid.
  • ABSENT_SUBSCRIBER: Temporary unavailable.
  • UNKNOWN: Could not verify.
  • phone_line_type: The type of phone number.
  • MOBILE
  • LANDLINE
  • VOIP
  • phone_carrier: The telecom provider name (e.g., "AT&T", "Vodafone").
  • phone_syntax_valid: true/false (Basic format check).
  • last_hlr_query: Timestamp of when the number was checked.
You can then filter and segment contacts based on these properties (e.g., "Line Type is MOBILE").

Common Use Cases

Use Case 1: SMS Campaign Optimization (Mobile vs Landline)

Scenario: A sales team is launching a text message campaign to 50,000 leads but doesn't know which are mobile numbers.
Result: Bulk HLR Lookup identifies 12,000 Landlines and 5,000 Dead numbers. The team excludes them, saving budget and improving delivery rates by focusing only on valid Mobile numbers.

Use Case 2: Pre-Campaign Database Clean

Scenario: A sales team is launching a major outbound calling campaign next week and has 50,000 contacts that have never been checked.
Result: All contacts checked overnight via HLR lookup. The team identifies 8,000 invalid numbers before the campaign starts, saving hundreds of wasted call attempts and improving connect rates.

Use Case 3: CRM Migration Audit

Scenario: A company just migrated to HubSpot from another CRM and wants to verify the quality of their imported contact data.
Result: Bulk HLR lookup reveals 15% of phone numbers are disconnected (DEAD) or invalid, allowing the team to prioritize re-enrichment efforts before going live.

Get Started

Ready to check your database?  Contact us  to book a discovery call and get a quote for your database size.