---
title: "Poll an async find-email request"
method: GET
path: "/api/v1/enrichment/find-email/status/{request_id}"
tags: ["Enrichment"]
---

# Poll an async find-email request

`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

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.

## Path parameters

- `request_id` string, required

## Response `200`

Successful Response

- object: Response for GET ``/enrichment/find-email/status/{request_id}``.
  - `requestId` string, required
  - `status` string, required: ``'pending'`` (still resolving), ``'completed'`` (resolution finished — check ``email`` for the result), or ``'failed'`` (internal error, retry the POST).
  - `email` string, nullable: The deliverable email, or null when resolution finished without finding one.
  - `errorMessage` string, nullable: Reason when ``status`` is ``'failed'``
  - `creditsCharged` number: Credits deducted — 0.5 on success, 0 otherwise
  - `createdAt` string, required
  - `completedAt` string, nullable

## Other responses

- `422`: Validation Error
- `429`: Rate limit exceeded. Retry after the number of seconds in the `Retry-After` response header.

---

[API](https://skmtc.dev/rodz/apis/rodz-api.md) · [All operations](https://skmtc.dev/rodz/apis/rodz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rodz/apis/rodz-api/revisions/3003505ff896?raw)