Stop paying to send SMS to landlines or dead numbers. Check a phone number’s country, serving carrier, original network, and line type in one call, and add porting, live network presence, or SIM swap signals when verifying high-risk actions.
+31612345678
POST/v1/lookup/phone-numberNumber details
Response body
200{ "phone_number": "+31612345678", "country_code": "NL", "network_info": { "carrier_name": "Vodafone", "mcc": "204", "mnc": "04" }, "original_network_info": { "carrier_name": "KPN", "mcc": "204", "mnc": "08" }, "flags": ["ported"], "line_type": "mobile" }
+31612345678
POST/v1/lookup/phone-numberNumber details
Response body
200{ "phone_number": "+31612345678", "country_code": "NL", "network_info": { "carrier_name": "Vodafone", "mcc": "204", "mnc": "04" }, "original_network_info": { "carrier_name": "KPN", "mcc": "204", "mnc": "08" }, "flags": ["ported"], "line_type": "mobile" }
+31612345678
POST/v1/lookup/phone-numberNumber details
Response body
200{ "phone_number": "+31612345678", "country_code": "NL", "network_info": { "carrier_name": "Vodafone", "mcc": "204", "mnc": "04" }, "original_network_info": { "carrier_name": "KPN", "mcc": "204", "mnc": "08" }, "flags": ["ported"], "line_type": "mobile" }
Inspect the base record and the difference between serving and issuing networks.
Validate phone numbers at signup or checkout and request deeper carrier checks when the risk warrants it.
Pass the number with its country calling code using a leading plus or 00 prefix. Bird rejects national-format numbers missing a country code so an ambiguous input cannot accidentally resolve to a valid subscriber in another country.
The base lookup returns the serving carrier, original issuing network, line type, and country in one response. Filter out landlines before sending SMS, or switch to a voice call when a customer provides a fixed-line number.
When your signup or checkout service retries after a network timeout, include an idempotency key on the lookup request so Bird replays the cached result without billing your workspace a second time.
Combine number validation with line classification, carrier routing, and live reachability checks.
Distinguish mobile numbers from landlines, VoIP, and toll-free lines before sending SMS or voice.
→Identify the current serving carrier and original issuing network to debug delivery and routing.
→Query the live mobile network to confirm whether a handset is active and reachable before contacting it.
→Organize teams in workspaces, control API access, and trace changes through audit logs.
Organization
Harbor
Access stays in its workspace.
Production/API keys
Signup service
ActiveAlex Lee
Admin
Today · UTC
Audit log
Organization
Harbor
Access stays in its workspace.
Production/API keys
Signup service
ActiveAlex Lee
Admin
Today · UTC
Audit log
Organization
Harbor
Access stays in its workspace.
Production/API keys
Signup service
ActiveAlex Lee
Admin
Today · UTC
Audit log