Close mobile menu
HomeSMSWhatsAppVoice CallingVoice MessagingConversationsBetaNumbersBetaVerifyReportingBetaHLRContactsGroupsLookupBalanceMMS

Request a Lookup

In this Lookup API Quickstart, we'll show you how to programmatically request a number Lookup via the Lookup API.

Step 1: Sign up for free

Before we get started, sign up to MessageBird for free and collect your live API key from the Developer Dashboard.

Step 2: Request your first Lookup

Next, enter your credentials and mobile number - as both the

- to the below snippet and copy it to your terminal. Now, hit enter!

curl -X GET \\
-H 'Authorization: AccessKey YOUR-API-KEY'

You’ve requested a Lookup with the Lookup API!

Step 3: View the response

Now, let’s view MessageBird’s HTTP response to your API call. If the set up was correct, you will receive a response similar to this:

"international":"+31 6 12345678",
"national":"06 12345678",

If something went wrong, you’ll receive an error response from the API. Don't worry, head over to Troubleshooting Lookup to understand the error.

Congrats! You can now programmatically request a Lookup with Lookup API using cURL.

Next steps

You may now want to check out these resources:


We’re always happy to help with code or other questions you might have! Check out our API Reference, Developer Tutorials, or contact our Support team.

Cookie Settings