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

# List CSV enrichment jobs

`GET /csv-enrichments`

## Request

- Base URL: `https://api.leadsforge.ai`
- URL: `https://api.leadsforge.ai/csv-enrichments`
- Auth: API key in header `Authorization`

Returns a paginated list of CSV enrichment jobs

## Query parameters

- `page` integer
- `size` integer

## Response `200`

OK

- CSVEnrichmentListResponse
  - `jobs` CSVEnrichmentJobResponse[]
    - `billedCredits` number
    - `billedEmailCredits` number
    - `billedLinkedinCredits` number
    - `billedPhoneCredits` number
    - `completedAt` string
    - `createdAt` string
    - `emailUnitPrice` number
    - `failedRows` integer
    - `failureReason` string
    - `fileSizeBytes` integer
    - `headers` string[]
    - `id` string
    - `linkedinUnitPrice` number
    - `listID` string
    - `mapping` CSVEnrichmentMappingResponse
      - `companyNameColumn` string
      - `companyUrlColumn` string
      - `emailColumn` string
      - `firstNameColumn` string
      - `lastNameColumn` string
      - `linkedinUrlColumn` string
      - `phoneColumn` string
    - `mappingReport` CSVEnrichmentMappingReport
      - `blocking` boolean
      - `columns` CSVEnrichmentColumnReport[]
        - `blocking` boolean
        - `column` string
        - `field` string
        - `reason` 'not_an_email' | 'not_a_phone_number' | 'not_a_linkedin_profile_url' | 'not_a_url' | 'not_a_name'
        - `tier` 'strict' | 'weak'
        - `valuesInvalid` integer
        - `valuesPresent` integer
    - `options` CSVEnrichmentOptionsResponse
      - `enrichEmail` boolean
      - `enrichLinkedin` boolean
      - `enrichPhone` boolean
    - `originalFilename` string
    - `phoneUnitPrice` number
    - `processedRows` integer
    - `reservedCredits` number
    - `skippedRows` integer
    - `startedAt` string
    - `status` 'draft' | 'configured' | 'started' | 'in_progress' | 'failed' | 'completed'
    - `succeededRows` integer
    - `totalRows` integer
    - `unitPrice` number
    - `updatedAt` string
  - `page` integer
  - `size` integer
  - `total` integer

## Other responses

- `400`: Bad Request
- `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)