## Get enrichment run status

**get** `/v1/enrichmentRun/{runId}`

Returns the status of an enrichment run by its ID.

**[Required scopes](/using-the-api/scopes/):** `contacts:read` for a contact run, `accounts:read` for an account run

**[Rate limit category](/using-the-api/rate-limits/):** Read

### Path Parameters

- `runId: string`

  The enrichment run ID.

### Returns

- `EnrichmentRunGetEnrichmentRunResponse object { id, completedAt, createdAt, 7 more }`

  - `id: string`

    The enrichment run ID.

  - `completedAt: string`

    When the run finished, or null while it is still open.

  - `createdAt: string`

  - `entityId: string`

    The ID of the record being enriched.

  - `entityType: "contact" or "account"`

    The type of record being enriched.

    - `"contact"`

    - `"account"`

  - `startedAt: string`

    When the run began executing, or null while it is queued.

  - `status: "queued" or "running" or "completed" or 2 more`

    Where the run is: `queued` and `running` are in flight; `completed`, `failed` and `timed_out` are final.

    - `"queued"`

    - `"running"`

    - `"completed"`

    - `"failed"`

    - `"timed_out"`

  - `targetFields: array of string`

    The fields this run set out to fill.

  - `trigger: "creation" or "manual"`

    What started the run: `creation` when the record was created, `manual` when requested through the API.

    - `"creation"`

    - `"manual"`

  - `updatedAt: string`

### Example

```http
curl https://api.lightfield.app/v1/enrichmentRun/$RUN_ID \
    -H 'Lightfield-Version: 2026-03-01' \
    -H "Authorization: Bearer $API_KEY"
```

#### Response

```json
{
  "id": "id",
  "completedAt": "completedAt",
  "createdAt": "createdAt",
  "entityId": "entityId",
  "entityType": "contact",
  "startedAt": "startedAt",
  "status": "queued",
  "targetFields": [
    "string"
  ],
  "trigger": "creation",
  "updatedAt": "updatedAt"
}
```