ReplySparrow Contacts
Enrich a contact's email (asynchronous)
Starts an email enrichment for the given contact and returns immediately, without waiting for the enrichment providers to respond. Recommended over the synchronous route for AI/MCP integrations and any client that cannot hold a long-running HTTP connection. Needs the contacts:write scope.
To verify completion, poll Get an enrichment job with the returned job_id until its status is no longer pending, or poll Get one contact: the enrichment is done once enriching_email is false. The email field is then filled if an email was found, and stays empty otherwise.
Costs 1 credit, charged only when an email is found (a miss or a provider error is refunded). A contact that already has an email gets it back for free, without a lookup. The balance is checked up front: with fewer than 1 credit the call fails with 402 and no job is started.
https://app.replysparrow.com/api/v1/contacts/{id}/enrich/email-asyncAuthorizations
Path Parameters
Contact id
Response
application/jsonEmail enrichment accepted and running in the background
Always true
Contact being enriched
How to check for completion
Enrichment job id, for Get an enrichment job
Always pending at first
curl --request POST \ --url https://app.replysparrow.com/api/v1/contacts/string/enrich/email-async \ --header 'Authorization: Bearer <token>'{ "accepted": true, "contact_id": "8f1c2c3e-5b7a-4a51-9d0e-2b6f8f6d9c11", "job_id": "0192c4a1-7d2e-7f3a-9b10-5e6f7a8b9c0d", "status": "pending", "message": "Poll GET /api/v1/contacts/enrich/jobs/0192c4a1-7d2e-7f3a-9b10-5e6f7a8b9c0d until status is no longer pending, or GET /api/v1/contacts/8f1c2c3e-5b7a-4a51-9d0e-2b6f8f6d9c11: the lookup is done once enriching_email is false."}