# Three steps to knowing your recipient.

Create an account, ask one question about a real phone number or email address, then add the properties your decision actually needs.

[Get Started](/dashboard/signup?returnTo=%2Fdashboard%2Fw%2Flookup)

[Contact Sales](/demo?product=lookup&source_page=%2Flookup-api%2Fgetting-started)

## Set up with your agent

[Read the agent setup guide](/docs/ai/set-up-your-agent)

Copy this prompt into your coding agent:

```text
Bird connects customer communications, data and automation. Help me build with Bird using my coding agent.
1. Read https://bird.com/docs/ai/set-up-your-agent.md and follow its setup workflow for this client. Use an existing connected Bird MCP server or signed-in CLI when available.
2. Read the product guide for the task I want to complete and inspect my existing integration. Identify the workspace, available operations and required setup.
3. Help me complete a first example for the product and destination I choose. Follow the operation through to its actual result, explain any uncertainty, and help me choose the next step.

Use this Bird page as the starting context: https://bird.com/lookup-api/getting-started
Read its Markdown alternative and linked guides. Keep the first example relevant to this page and the customer outcome I choose. Preserve the supplied campaign context when following Bird signup or sales links.
```

[Read customer stories](/customers)

[Explore Enterprise](/enterprise)

- [Airwallex](/customers/airwallex)
- [Glovo](/customers/glovo)
- [Zillow](/customers/zillow)
- Uber
- [Binance](/customers/binance)
- Adobe
- Meta
- PayPal
- Pinterest
- Square
- [Al Jazeera](/customers/aljazeera)
- [Aramex](/customers/aramex)
- [Bazaar Technologies](/customers/bazaar)
- [ComparaOnline](/customers/compara)
- [Emma](/customers/emma)

## From sign-up to your first answer in an afternoon.

There is nothing to create, nothing to poll, and nothing to clean up. Follow these three steps and Lookup is in production.

- **01** Sign up for Bird. Create your account and issue an API key with the lookup scope. There is no plan to choose and no resource to provision, but every lookup is charged to your organization's prepaid balance, so top it up before the first one goes out.
- **02** Run your first lookup. One request, one answer. A phone number comes back with its country, the network serving it, the network that issued it, whether it has moved network, and a coarse line type. An email address comes back with one verdict on whether it will accept mail. The Lookup page in the dashboard runs both, one at a time, before you write any code. [Phone number guide &rarr;](/docs/guides/lookup/phone-numbers) [Email address lookup &rarr;](/lookup-api/features/email)
- **03** Add the properties you need. Name classification, porting, presence, roaming, sim_swap, or score in type to answer the finer questions. Each block reports its own status, only a delivered block is billed, and a lookup that fails costs nothing. Send an Idempotency-Key so a retry replays the answer you already paid for. [Lookup overview &rarr;](/docs/guides/lookup/overview)

## Ask before you send.

Named fields from real carrier and mailbox data, one API key shared with the rest of the platform, and a bill that only covers the answers you got. Sign up and run your first lookup in under five minutes.

[Explore the Lookup API](/lookup-api)



## Related resources

- [Phone number lookup: check a number before you send](/learn/lookup/phone-number-lookup-check-a-number-before-you-send) (video)

[Get an implementation brief](/learn/workspace?topic=lookup)
