API Overview
MisarReach REST API reference — base URL, authentication, credits, and endpoint index.
Base URL
https://api.misar.io/reachAuthentication
Pass your API key as a Bearer token on every request:
Authorization: Bearer msr_your_key_hereGenerate keys from Dashboard → Settings → API Keys.
Credits
Lead Finder operations consume credits from your wallet:
| Operation | Cost |
|---|---|
| Lead search job | 1 credit |
| Email verification (per email) | 1 verification credit |
| Lead scoring (per lead) | 1 AI credit |
Free accounts receive 25 lead searches per month at no credit cost. Once the free allowance is exhausted, credits are required.
Endpoints
| Endpoint | Methods | Description |
|---|---|---|
/api/lead-finder/search | POST | Start an async lead search job |
/api/lead-finder/jobs/:jobId | GET | Get job status |
/api/lead-finder/jobs/:jobId/feedback | POST | Submit quality feedback on results |
/api/lead-finder/leads | GET | List leads from a completed job |
/api/lead-finder/verify | POST | Verify email deliverability (batch, max 20) |
/api/lead-finder/score | POST | AI-score leads by jobId or leadIds |
/api/lead-finder/lists | GET POST | Manage lead lists |
/api/lead-finder/lists/:listId/sync | POST | Sync list to campaign |
/api/lead-finder/enrich | POST | Enrich existing lead data |
/api/lead-finder/discover | POST | Discover leads by company/domain |
/api/lead-finder/preview-message | POST | Preview AI-generated outreach message |
/api/deals | GET POST | List or create deals |
/api/deals/:id | GET PATCH DELETE | Read, update, or delete a deal |
/api/pipeline | GET POST | Get pipeline board or move a deal's stage |
/api/unsubscribe | GET | Unsubscribe a contact from all campaigns |
/api/autopilot/start | POST | Start an Autopilot campaign run |
/api/autopilot/:id/status | GET | Get Autopilot run status |
/api/autopilot/runs | GET | List Autopilot runs |
Error Format
All errors return:
{ "error": "Human-readable message" }See Errors for status codes and common error types.