---
title: "Get enrichment runs"
method: GET
path: "/enrichments/{listID}/runs"
tags: ["enrichment"]
---

# Get enrichment runs

`GET /enrichments/{listID}/runs`

## Request

- Base URL: `https://api.leadsforge.ai`
- URL: `https://api.leadsforge.ai/enrichments/{listID}/runs`
- Auth: API key in header `Authorization`

Returns a list's enrichment run history (newest first), keyset-paginated.

## Path parameters

- `listID` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

OK

- EnrichmentRunsResponse
  - `nextCursor` string
  - `runs` EnrichmentRunResponse[]
    - `channels` ChannelBreakdown
      - `email` ChannelCount
        - `charged` integer
        - `delivered` integer
      - `linkedin` ChannelCount
        - `charged` integer
        - `delivered` integer
      - `phone` ChannelCount
        - `charged` integer
        - `delivered` integer
      - `qualification` ChannelCount
        - `charged` integer
        - `delivered` integer
    - `completedAt` string
    - `consumedCredits` number
    - `contactsProcessed` integer
    - `id` string
    - `ranBy` string
    - `refundedCredits` number
    - `reservedCredits` number
    - `runNumber` integer
    - `startedAt` string
    - `status` 'completed' | 'cancelled' | 'in_progress'

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `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)