# List Enrichments

`GET https://api.getprospect.com/v2/enrichments`

Lists the workspace enrichments, newest first: the ones created through the API and the ones created in the App. Filter by `status` or `source`; `per_page` up to 100. Free; a `poll` (0 rate-limit units, per-second window only).

## Authentication

Pass your API key in the `x-api-key` header.

## Query parameters

- `page` (integer, optional, min: 1, default: 1): The page, 1-based.
- `per_page` (integer, optional, min: 1, max: 100, default: 25): Jobs per page.
- `status` (enum, optional): Only the jobs in this status. Allowed values: `queued`, `sampling`, `matching`, `awaiting_confirmation`, `enriching`, `finding`, `assembling`, `completed`, `failed`, `cancelled`.
- `source` (enum, optional): Only the jobs created through the API (`api`, JSON rows) or the App (`file`, a CSV upload). Allowed values: `api`, `file`.

## Example request

```bash
curl --request GET \
  --url https://api.getprospect.com/v2/enrichments \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Response 200

One page of jobs.

```json
{
  "success": true,
  "data": [
    {
      "id": "6703f1c2a9e4b5d6c7f80931",
      "type": "people",
      "name": "Q4 webinar leads",
      "source": "api",
      "status": "enriching",
      "stopped_reason": null,
      "options": {
        "enrich_email": true,
        "enrich_phone": false
      },
      "progress": {
        "percent": 42,
        "done": 4200,
        "total": 10000
      },
      "counts": {
        "rows": 10000,
        "matched": 6100,
        "not_matched": 3700,
        "invalid": 200,
        "emails_found": 4300,
        "phones_found": 0
      },
      "credits_used": {
        "email": 3900,
        "phone": 0
      },
      "created_at": "2026-10-17T10:00:00.000Z",
      "started_at": "2026-10-17T10:00:00.000Z",
      "finished_at": null,
      "results_expires_at": null,
      "links": {
        "self": "/v2/enrichments/6703f1c2a9e4b5d6c7f80931",
        "job": "/v2/jobs/6703f1c2a9e4b5d6c7f80931",
        "results": null,
        "csv": null,
        "jsonl": null
      }
    }
  ],
  "metadata": {
    "timestamp": "2026-10-05T09:00:00.000Z",
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_pages": 1,
      "total_count": 1
    }
  }
}
```

## Response 400

Invalid query (`VALIDATION_ERROR`; `payload.code` says which kind of mistake).

```json
{
  "success": false,
  "data": null,
  "metadata": {
    "timestamp": "2026-10-05T09:00:00.000Z"
  },
  "errors": [
    {
      "name": "VALIDATION_ERROR",
      "message": "source: \"csv\" is not an accepted value. Accepted: api, file",
      "payload": {
        "field": "source",
        "code": "value_not_allowed",
        "received_value": "csv",
        "received_type": "string",
        "invalid_values": [
          "csv"
        ],
        "allowed_values": [
          "api",
          "file"
        ],
        "constraints": {
          "isIn": "source must be one of the following values: api, file"
        }
      }
    }
  ]
}
```

## Response 401

Missing, unknown or inactive credentials (`UNAUTHORIZED`).

## Response 429

Over the `poll` rate limit (`RATE_LIMIT`); wait `Retry-After` seconds. Sent only where rate limits are enforced for the caller channel.

## Response 500

Unexpected server error.