---
title: "Poll a phone enrichment result"
method: GET
path: "/api/v1/enrichment/phone/{enrichment_id}"
tags: ["Enrichment"]
---

# Poll a phone enrichment result

`GET /api/v1/enrichment/phone/{enrichment_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/phone/{enrichment_id}`
- Auth: HTTP bearer

Check the status and result of a phone enrichment lookup you submitted — poll this endpoint until the job completes and receive the contact's phone number if Rodz found a match.

**Input:** enrichmentId (the job ID returned from your POST submission)

**Output:** Current status (pending while running, completed when done, or failed if the lookup errored), the E.164 phone number if found (or null if no match), credits charged (5 if successful, 0 otherwise), and error details if applicable. Job records are kept for 1 hour after submission.

## Path parameters

- `enrichment_id` string, required

## Response `200`

Successful Response

- object: Phone enrichment job state.
  - `enrichmentId` string, required
  - `status` string, required: One of: pending, completed, failed
  - `phone` string, nullable: E.164 phone number; null if not found
  - `creditsCharged` integer: Credits deducted (5 on success, 0 otherwise)
  - `error` 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)