Enrichment

Poll an async find-email request

Check your async email-finding request and retrieve the found email address when it's ready.

Input: requestId (the unique ID returned when you submitted the email-finding request via POST)

Output: The current status ('pending' while resolving, 'completed' when resolution finished, or 'failed' on an internal error — retry the POST), the discovered email address (or null if resolution finished without finding a deliverable email), errorMessage (a reason string when status is 'failed', otherwise null), creditsCharged (0.5 credits on success, 0 otherwise), and timestamps (createdAt, completedAt) showing when the request was submitted and when resolution finished. Results are retained for 24 hours after submission.

get/api/v1/enrichment/find-email/status/{request_id}

Request

Base URL: https://api.rodz.io (the document declares no server; this is the origin it was published from)
URL: https://api.rodz.io/api/v1/enrichment/find-email/status/{request_id}
Auth: HTTP bearer

Path parameters

request_idstring required

Response

Successful Response

requestIdstring required

statusstring required

'pending' (still resolving), 'completed' (resolution finished — check email for the result), or 'failed' (internal error, retry the POST).

emailstring nullable

The deliverable email, or null when resolution finished without finding one.

errorMessagestring nullable

Reason when status is 'failed'

creditsChargednumber

Credits deducted — 0.5 on success, 0 otherwise

createdAtstring required

completedAtstring nullable

Example response

{
  "completedAt": "2026-05-31T14:30:42+00:00",
  "createdAt": "2026-05-31T14:30:00+00:00",
  "creditsCharged": 0.5,
  "email": "marie.dupont@lemlist.com",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed"
}

Changes

No recorded changes to this operation across all 1 revision of this API.