Get a job

API referenceEmail Finder

From the Email Finder API reference. Requests use the base URL https://app.warmerly.com/api/v1 and an API key, see Authentication.

text

GET /email-finder/jobs/:id

Fetch the current status of a lookup job, whether it came from a single or bulk request.

bash

curl https://app.warmerly.com/api/v1/email-finder/jobs/3f9a2e2a-1c4b-4a2e-9b1e-2f6c8a7d5e10 \
  -H "X-Api-Key: wmv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "X-Project-Id: 8f14e45f-ceea-4c6a-8c8d-6b1a5b5c9c1a"

json

{
  "job": {
    "id": "3f9a2e2a-1c4b-4a2e-9b1e-2f6c8a7d5e10",
    "status": "scraping",
    "confidence": null,
    "error": null,
    "createdAt": "2026-07-02T09:14:03.000Z",
    "completedAt": null
  },
  "result": null
}

status moves through pending → resolving → scraping → verifying → done (or failed). result is populated once status is "done" (and is null if no email was found); on "failed", check job.error for the reason. A job that doesn't exist, or that belongs to a different project than the one in X-Project-Id, returns 404 not_found.

Was this page helpful?

Get a job

More from Email Finder