---
title: "Enrich CSV (async)"
method: POST
path: "/api/v1/enrich/csv/async"
tags: ["Enrich"]
---

# Enrich CSV (async)

`POST /api/v1/enrich/csv/async`

## Request

- Base URL: `https://app.getleads.io`
- URL: `https://app.getleads.io/api/v1/enrich/csv/async`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Upload a CSV and enqueue it for background enrichment.
Poll the result via the returned `runId`.

## Request body `multipart/form-data`

- object
  - `file` string, binary
  - `mode` 'linkedin' | 'work_email' | 'person' | 'phone'
  - `mapping` string
  - `maxRows` integer
  - `fileName` string

## Response `202`

Enrichment queued

- object
  - `ok` boolean
  - `runId` string
  - `jobStatus` 'queued'
  - `rows` integer
  - `worstCaseCredits` integer

## Other responses

- `401`: Missing or invalid API key

---

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