What is carrier lookup api?

carrier lookup api is a developer workflow for sending phone, carrier, messaging, or account-check jobs to BulkChecker and downloading structured results.

Can I upload CSV files?

Yes. Use the file workflow for larger lists and the API workflow for recurring backend jobs.

What should I store from the response?

Store normalized input, status, confidence, task ID, and the result segment your team needs for routing or review.

Carrier Lookup API · Batch jobs · MNP tracking

Bulk Carrier Lookup API: Batch List Enrichment

Enrich large phone lists with carrier, line type, country, region, and ported-number status via batch API jobs.

Detection

HLR-based data

Routing

MNP aware

Scale

Bulk endpoint

Try for Free Log in

Need a product explanation for ported carrier routing? See Number Portability Check.

POST /api/v1/detect

curl -X POST "https://api.bulkchecker.io/api/v1/detect" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "hlr-lookup",
    "country": "US",
    "phones": ["+14155550198", "+442071838750"]
  }'

Response preview

carrierT-Mobile USA

line_typemobile

portedfalse

countryUS

Network intelligence

Batch API Features

Use carrier intelligence to route messages, segment phone lists, enrich CRM data, and reduce low-quality phone activity.

HLR-based carrier data

Return network-backed carrier and reachability data for routing and segmentation.

MNP (ported number) tracking

Detect numbers that moved between carriers so your routing follows the current network.

Line type intelligence

Identify mobile, landline, VoIP, toll-free, and unknown line types for routing and risk rules.

Country/region detection

Resolve country, region, and dialing context for segmentation and international workflows.

HLR support

HLR lookup API section

Check phone status and carrier signals by API where HLR data is available. This section explains HLR-style workflows inside the Carrier Lookup API instead of creating a separate HLR API page before the product has a distinct endpoint and pricing model.

Batch HLR lookup jobs

Submit phone arrays or files, poll task status, and export status, carrier, line type, and routing fields when coverage supports them.

HLR lookup fields

Typical fields can include active/disconnected signals, current carrier, roaming, MNP context, MCC/MNC, and review flags.

HLR lookup API vs carrier lookup API

Carrier lookup focuses on carrier and line type enrichment. HLR-style data adds phone status and network state where HLR data is available.

Availability, credits, and error behavior vary by market and product configuration. Use HLR Lookup and Number Portability Check for non-developer explanations.

Fast integration

Quick Start

Create a key, submit a carrier lookup batch, and use the JSON response in routing, segmentation, and CRM workflows.

Get API key

Create a key in the BulkChecker app API Center and keep it on your server.

First curl request

curl -X POST "https://api.bulkchecker.io/api/v1/detect" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "hlr-lookup",
    "country": "US",
    "phones": ["+14155550198", "+442071838750"]
  }'

Sample JSON response

{
  "mode": "async",
  "task_id": "qH5rZ7Lp3Wm9",
  "message": "Task queued.",
  "summary": {
    "total": 10000,
    "cost_deducted": 1.000000
  }
}

Reference

Endpoints

Use the unified BulkChecker API for carrier workflows: send the carrier or HLR product slug, poll the task, and download results.

POST

POST /api/v1/detect

Submit phone arrays with a product slug for async carrier, line type, and status enrichment.

GET

GET /api/v1/tasks/{task_id}/result

Retrieve the download URL after the task reaches completed status.

Developer libraries

SDKs (Python/Node/Ruby/PHP)

Integrate carrier lookup with official-style SDK patterns and simple server-side requests.

Python

pip install bulkchecker

Node

npm i bulkchecker

Ruby

gem install bulkchecker

PHP

composer require bulkchecker/sdk

Volume pricing

Pricing Tiers

Start small, then move to lower per-lookup rates as your carrier lookup volume grows.

Tier	Monthly volume	Price	Best for
Starter	10K lookups	$5	Testing and small apps
Growth	100K lookups	$40	Batch routing and recurring jobs
Scale	1M+ lookups	Custom	SMS gateways and high-volume systems

Workflows

Use Cases

Carrier lookup API results are most useful when they clean and enrich phone lists before outreach or CRM import.

SMS gateway routing

Route messages through the right carrier path and suppress numbers that should not receive SMS.

Pre-campaign list segmentation

Check country, line type, carrier, and ported-number signals before splitting or suppressing campaign lists.

Bulk CRM data enrichment

Append carrier and line-type fields to large CRM exports so teams can clean, segment, and route records.

Alternative

Compare with Twilio Lookup API

Twilio Lookup is strong for teams already deep in the Twilio ecosystem. bulkchecker.io focuses on carrier lookup plus bulk workflows, routing signals, and high-volume pricing.

Read Twilio alternative

Category	bulkchecker.io	Twilio Lookup API
Carrier lookup	Bulk endpoint + single lookup	Lookup API
Bulk workflow	Native /api/v1/detect workflow	Requires custom batching
Best fit	SMS routing, campaign segmentation, CRM enrichment	Existing Twilio stack users

FAQ

Carrier Lookup API FAQ

Short answers for developers evaluating carrier lookup integration.

API rate limits?

Rate limits depend on plan and traffic profile. Higher tiers can request increased throughput for bulk processing and routing.

Support options?

Support options are available for production customers that need higher volume and operational help.

Can I get carrier data offline?

Yes. Use the bulk endpoint or CSV workflow when you need offline enrichment for campaigns, CRM exports, or data warehouse jobs.

Webhook support?

Webhook notifications are supported for bulk jobs so systems can be notified when carrier lookup exports are ready.

How is this rated against the best carrier lookup API?

Independent reviewers rank bulkchecker.io among the best carrier lookup API options for price-per-lookup, post-MNP accuracy, and bulk batch endpoints. Free tier available for testing.

Carrier lookup cluster

Related carrier lookup pages

Open cluster hub

Carrier Lookup GuidePillar guide for carrier data, line type, HLR, and routing use cases.Carrier LookupFind carrier, country, line type, and routing metadata for phone numbers.HLR LookupCheck mobile network and reachability signals for validation workflows.Number Portability CheckCheck MNP and portability signals before routing or list screening.Line Type CheckerSeparate mobile, landline, VoIP, and virtual number traffic.Free Carrier LookupPreview carrier and line type signals with a free single-number lookup.

AI answer engines

Request an AI summary of BulkChecker

Open BulkChecker in your preferred AI assistant to review its bulk WhatsApp, Telegram, phone validation, carrier lookup, social account, crypto exchange, CSV upload, and API workflows.

ChatGPT Claude Perplexity Gemini Google AI Mode Grok

The prompt points assistants to BulkChecker.io, live pricing, product pages, and API documentation.