---
title: "Poll the status of an enrichment job (people or companies)"
method: GET
path: "/v1/enrich/status/{requestId}"
tags: ["enrichment"]
---

# Poll the status of an enrichment job (people or companies)

`GET /v1/enrich/status/{requestId}`

## Request

- Base URL: `https://developer.saleshandy.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.saleshandy.com/v1/enrich/status/{requestId}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/docs/v1/enrich/status/:requestId/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `requestId` string, required

## Response `200`

Enrichment job status

- object
  - `message` string
  - `payload` object
    - `requestId` string
    - `status` 'in-progress' | 'completed' | 'failed'
    - `totalRecords` number
    - `processed` number
    - `succeeded` number
    - `failed` number
    - `alreadyRevealed` number: Leads already revealed before this request for which no new data was delivered
    - `creditsCharged` number

## Other responses

- `400`: 1001: Invalid token<br><br>
- `404`: 40000: Enrichment job not found<br><br>

## Changes

- **2026-09-16** `a483e105b20f`: 1 info
  - added the optional property `payload/alreadyRevealed` to the response with the `200` status

[Operation history](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/changes/v1/enrich/status/:requestId/get.md)

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) - [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) - [OpenAPI document](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/revisions/e7a29c931aa7?raw)