Contacts

Get an enrichment job

Returns the state of an async email or phone lookup. status is pending while it runs, then done (found), not_found (nothing found, no credits charged) or failed (see error, e.g. insufficient_credits). Poll every few seconds. Needs the contacts:read scope.

gethttps://app.replysparrow.com/api/v1/contacts/enrich/jobs/{job_id}

Authorizations

Authorizationstringheaderrequired

Your API key from Settings → API, sent as Bearer <token>.

Path Parameters

job_idstringrequired

Job id returned when the lookup was started

Response

application/json

The job

job_idstringrequired

Job id

contact_idstringrequired

Contact looked up

kindstringrequired

email or phone

statusstringrequired

pending, done, not_found or failed

resultobject

Same shape as the synchronous enrich response, once finished

errorstring

Why the job failed

created_atstring<date-time>

When the job was started

finished_atstring<date-time>

When it finished

Ctrl+I

Get an enrichment job

curl --request GET \  --url https://app.replysparrow.com/api/v1/contacts/enrich/jobs/string \  --header 'Authorization: Bearer <token>'

{  "job_id": "0192c4a1-7d2e-7f3a-9b10-5e6f7a8b9c0d",  "contact_id": "8f1c2c3e-5b7a-4a51-9d0e-2b6f8f6d9c11",  "kind": "email",  "status": "done",  "result": {    "found": true,    "email": "ada@example.com",    "verified": true,    "provider": "treg",    "already_known": false,    "credits_used": 1  },  "error": null,  "created_at": "2026-10-24T09:12:44.000Z",  "finished_at": "2026-10-24T09:12:49.000Z"}