---
title: "Developer Phone Lookup API"
---

# Developer Phone Lookup API

Developer Phone Lookup API: REST Endpoints & Interactive Console: SMSRiver

- [Skip to main content](#main-content) [sms river .com](/) [Public Inboxes](/#numbers-section) [Country Codes](/country-codes/) [Workbench](/workbench/) [Tools](/tools/) [Developer API](/developer/) [Pricing](/pricing/) [Log In](/accounts/login/) [Log In](/accounts/login/) [Get API Key](/pricing/) [Home](/) [Developer](/developer/) Phone Lookup API REST API Specification # Developer Phone Lookup API Reference Inspect, format, and classify phone numbers with single-digit millisecond latency. Detect country codes, verify numbering-plan validity, classify mobile vs landline vs VoIP lines, and retrieve carrier attribution. ## Interactive API Test Console Live Production Endpoint Execute a live request to /api/v1/lookup/ directly from your browser to inspect real response payloads. Phone Number Default Country Context United States (+1) United Kingdom (+44) Germany (+49) Canada (+1) France (+33) Australia (+61) Netherlands (+31) Spain (+34) Sweden (+46) Execute Lookup Request Latency: -- ms Response Payload • application/json HTTP 200 OK GET POST /api/v1/lookup/ Evaluates a single phone number. Accepts query parameters via GET, or JSON body via POST. ### Request Parameters Field Type Requirement Description phone string Required The raw phone number in international, E.164, or domestic national format. country string Optional 2-letter ISO country code (e.g. US, GB, DE) used as context when country dialing prefix is absent. Defaults to US. ### Example cURL Request curl -s "https://smsriver.com/api/v1/lookup/?phone=%2B14155552671&country=US" \ -H "Authorization: Bearer YOUR_API_KEY" POST /api/v1/lookup/batch/ Evaluates a batch of up to 100 phone numbers in a single atomic HTTP round-trip. ### Request Body (JSON) { "numbers": [ "+14155552671", "+447911123456", "+491512283200", "+18005550199" ], "default_country": "US" } ### Example Batch Response { "total_submitted": 4, "valid_count": 4, "invalid_count": 0, "mobile_count": 3, "other_line_count": 1, "results": [ { "raw_input": "+14155552671", "formats": { "e164": "+14155552671", "international": "+1 415-555-2671", "national": "(415) 555-2671", "rfc3966": "tel:+14155552671" }, "country_code": "US", "country_name": "United States", "dial_code": "+1", "line_type": "mobile", "line_type_label": "Mobile / Cellular", "is_valid_format": true, "carrier": "T-Mobile / AT&T Mobility" } ] } ## SDK & Language Examples Python Node.js Go Copied to clipboard FULL PACKET INSPECTION SMS ### Line: DE +49 ... Timestamp: Just now Extracted code Copy Code Message Body: Copy Full Message [Open Live Inbox](#) sms river .com Central Office carrier inventory platform & developer SMS verification sandbox. Receive OTP codes instantly with zero SIM card requirement. Public numbers · Live inboxes · Developer tools Public Inboxes [United States (+1)](/receive-sms/us/)

- [United Kingdom (+44)](/receive-sms/gb/)

- [Canada (+1)](/receive-sms/ca/)

- [Philippines (+63)](/receive-sms/ph/)

- [Germany (+49)](/receive-sms/de/)

Developer & Tools

- [SMS Debugging Workbench](/workbench/)

- [Phone Number Inspector](/tools/phone-number-inspector/)

- [Bulk Phone Validator](/tools/bulk-phone-validator/)

- [Phone Lookup API](/developer/phone-lookup-api/)

- [E.164 Phone Formatter](/tools/phone-number-formatter/)

- [SMS Segment Calculator](/tools/sms-segment-calculator/)

- [Webhook Validator](/tools/webhook-payload-validator/)

Guides & Trust

- [Country Calling Codes](/country-codes/)

- [Troubleshooting Hub](/troubleshooting/)

- [Carrier Comparisons](/compare/)

- [Developer Reference](/developer/)

- [OpenAPI Specification](/openapi.json)

- [MCP Tools Manifest](/.well-known/mcp.json)

- [Privacy & Security Guides](/guides/)

- [Engineering Articles](/articles/)

© 2026 SMSRiver. Operating on Cloudflare Workers & D1. Adheres to CTIA Messaging Principles and 10DLC compliance standards.

[About](/about/)
[Contact](/contact/)
[Privacy Policy](/privacy/)
[Terms of Service](/guides/terms-of-service/)
Cookie Preferences