DEVELOPER API

One API. Infinite Possibilities.

Integrate carrier and number lookup into your applications with our RESTful API. Clean docs, fast responses, and Python integration support.

Your App
→
Brain Lead API
→
Carrier & Number Data
→
Result

Quick Start in 60 Seconds

Get your API key and start looking up carriers immediately

curl -X POST https://brainlead.dev/api/v1/carrier/lookup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number": "+14155552671"}'

# Response:
{
  "status": "valid",
  "number": "+14155552671",
  "carrier": "AT&T",
  "line_type": "mobile",
  "location": "New York, NY",
  "ported": false,
  "is_wireless": true
}
import requests

response = requests.post(
    "https://brainlead.dev/api/v1/carrier/lookup",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"number": "+14155552671"}
)

result = response.json()
print(result["carrier"])   # "AT&T"
print(result["line_type"]) # "mobile"

Try It Live

Test our API right here — no signup needed


            

Available Endpoints

Everything you need to look up carriers and manage usage

POST
/api/v1/carrier/lookup
Look up carrier info for a phone number. Returns carrier name, line type, and location.
POST
/api/v1/carrier/bulk
Bulk carrier lookup. Submit up to 100 numbers per request.
GET
/api/v1/account/usage
Get your account usage statistics, credit balance, and API call history.
GET
/api/v1/account/credits
Check your remaining credit balance and plan details.

Official Python SDK

Python integration is our primary supported language interface

🐍
Python SDK
pip install brainlead

Currently in private beta. Contact support for early access.

Get Your API Key — It's Free

Create a free account to receive starter API credits. No credit card required.

Create Free Account