Overview

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

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

• 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

1. Create an API key in the dashboard.
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

• Quick start: curl, Node, Python examples.
• Authentication: how API keys work.
• Endpoints: full reference.