---
title: "Import a company list from your current vendor"
method: POST
path: "/v1/migration-import"
---

# Import a company list from your current vendor

`POST /v1/migration-import`

## Request

- Base URL: `https://api.reqbeat.com`
- URL: `https://api.reqbeat.com/v1/migration-import`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Migration import from an incumbent: a switcher's uploaded
Coresignal/Apollo company list, resolved to the panel and enriched with
the hiring-motion column; every miss is routed to a real coverage
request, so switching cost drops to near zero without a second "please
crawl this" mechanism. Not billable -- same convention as `/quickstart`
and `/onboarding`.

Requires the `write` scope.

## Request body

- MigrationImportRequest
  - `contact_email` string, required
  - `rows` MigrationImportRow[], required
    - `name` string, nullable
    - `domain` string, nullable

## Response `200`

Successful Response

- MigrationImportResponse
  - `covered` integer, required
  - `total` integer, required
  - `resolved` ResolvedImportRow[], required
    - `name` string, nullable, required
    - `domain` string, nullable, required
    - `company_id` integer, required
    - `enrichment` object, required
  - `misses` MissedImportRow[], required
    - `name` string, nullable, required
    - `domain` string, nullable, required

## Other responses

- `401`: No API key was sent.
- `403`: The presented key is invalid or revoked, or (see `x-required-scope` on this operation) it does not carry the scope this operation requires.
- `422`: Validation Error

---

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