Less boo. More booked. Halloween offer: 30 days free on any paid plan. Claim 30 days freeEvery new account gets one free mailbox for warmup and replies. No domain to buy. See how it works

Skip to content

List results

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/results

Lists jobs for the current project, each joined with its winning discovered email (if any), newest first. Cursor-paginated.

Query paramTypeDescription
statusstringFilter by job status: pending, resolving, scraping, verifying, done, failed.
batchIduuidRestrict to jobs from a specific bulk batch.
minConfidenceinteger (0-100)Only include results with confidence at or above this value.
cursorISO 8601 datetimePass the previous response's nextCursor to fetch the next page.
limitinteger (1-100, default 25)Page size.
bash
curl "https://app.warmerly.com/api/v1/email-finder/results?status=done&limit=25" \
  -H "X-Api-Key: wmv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "X-Project-Id: 8f14e45f-ceea-4c6a-8c8d-6b1a5b5c9c1a"
json
{
  "results": [
    {
      "id": "3f9a2e2a-1c4b-4a2e-9b1e-2f6c8a7d5e10",
      "status": "done",
      "confidence": 92,
      "inputDomain": "acme.com",
      "inputName": null,
      "batchId": null,
      "createdAt": "2026-07-02T09:14:03.000Z",
      "email": "jane.doe@acme.com",
      "verifyStatus": "verified",
      "source": "pattern_guess"
    }
  ],
  "nextCursor": "2026-07-02T09:14:03.000Z"
}

Pass nextCursor as the cursor query param to fetch the next page; it is null on the last page.

Was this page helpful?