---
title: "List enrichment jobs"
method: GET
path: "/enrichment/jobs"
tags: ["enrichment"]
---

# List enrichment jobs

`GET /enrichment/jobs`

## Request

- Base URL: `https://api.leadsforge.ai`
- URL: `https://api.leadsforge.ai/enrichment/jobs`
- Auth: `ApiKeyAuth` (a scheme the document does not define)

List the caller's enrichment jobs, most recent first. Use the filters (status, channel, clientRequestID, from/to) to recover a job when the job ID is unknown.

## Query parameters

- `offset` integer
- `limit` integer, required
- `status` 'in_progress' | 'completed' | 'failed'
- `channel` 'email' | 'phone' | 'linkedin'
- `clientRequestID` string
- `from` string
- `to` string

## Response `200`

Jobs

- EnrichmentJobsListResponse
  - `jobs` EnrichmentJobResponse[]
    - `channel` string
    - `clientRequestID` string
    - `completedAt` string
    - `consumedCredits` number
    - `createdAt` string
    - `failed` integer
    - `jobID` string
    - `processed` integer
    - `reservedCredits` number
    - `resultsURL` string
    - `status` string
    - `statusURL` string
    - `succeeded` integer
    - `total` integer
    - `updatedAt` string
    - `webhookURL` string
  - `limit` integer
  - `offset` integer
  - `total` integer

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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