# Overview (/docs/api)



Seven endpoints. Bearer-token auth. HMAC-signed webhooks. Ship your integration in an afternoon.

Base URL [#base-url]

```
https://api.decisionmaker.email
```

All endpoints sit under `/api/v1/*` and accept JSON bodies. Every request needs an `Authorization: Bearer <key>` header.

What you get [#what-you-get]

* **Email search.** Kick off an AI-powered search for an executive email by domain and role, poll for results.
* **Cached results.** Reuse searches across your team without re-spending credits.
* **Credit and stats introspection.** Check balances and totals with a single call.
* **Webhooks.** Receive a signed HTTP POST when an async search completes or fails, instead of polling.

How it fits together [#how-it-fits-together]

1. Create an API key in the [dashboard](/dashboard/api-keys).
2. Call `POST /api/v1/find-email` with a `url` and `role`. You get back a `searchId`.
3. Either poll `POST /api/v1/search-status` or register a webhook endpoint to receive the result asynchronously.
4. When the search completes, you get an array of validated emails with confidence scores.

Next [#next]

* [Quick start](/docs/api/quickstart): curl, Node, Python examples.
* [Authentication](/docs/api/authentication): how API keys work.
* [Endpoints](/docs/api/endpoints): full reference.