---
title: "Upload company CSV file"
method: POST
path: "/lists/{listID}/company-file/upload"
tags: ["lists"]
---

# Upload company CSV file

`POST /lists/{listID}/company-file/upload`

## Request

- Base URL: `https://api.leadsforge.ai`
- URL: `https://api.leadsforge.ai/lists/{listID}/company-file/upload`
- Auth: API key in header `Authorization`

Accepts a CSV file and returns parsed column headers for mapping

## Path parameters

- `listID` string, required

## Request body `multipart/form-data`

- object
  - `file` string, binary, required: CSV file with company identifiers

## Response `200`

OK

- CompanyFileUploadResponse
  - `columns` string[]
  - `fileID` string
  - `totalRows` 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)