---
title: "Create job"
method: POST
path: "/companies/enrich/bulk"
tags: ["Company / Bulk Enrichment"]
---

# Create job

`POST /companies/enrich/bulk`

## Request

- Base URL: `https://api.companyenrich.com`
- URL: `https://api.companyenrich.com/companies/enrich/bulk`
- Auth: API key in header `Authorization`

**Cost:** 1 credit per domain successfully enriched (charged on completion)

Creates an asynchronous bulk enrichment job for up to 10,000 domains.
Returns a job ID immediately. The webhook URL will be called with a notification when processing completes.

Use the status endpoint to track progress and retrieve results.

## Query parameters

- `expand` string[]

## Request body

- BulkEnrichmentRequest
  - `domains` string[], required: A list of domains to enrich. Up to 10,000 domains can be provided.
  - `webhook_url` string, uri, nullable: The webhook URL to receive the notification when processing completes.

## Response `200`

OK

- BulkEnrichmentResponse
  - `job_id` string, uuid: Unique identifier for the bulk enrichment job.
  - `status` 'pending' | 'processing' | 'completing' | 'completed' | 'failed': Current status of the job (pending, processing, completing, completed, failed).
  - `total_domains` integer: Total number of unique domains to be enriched.
  - `estimated_credits` integer: Estimated credit cost for the enrichment job.
  - `invalid_url_count` integer: Number of input URLs that could not be parsed as valid LinkedIn company URLs.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `422`: Unprocessable Entity
- `429`: Too Many Requests

---

[API](https://skmtc.dev/companyenrich/apis/company-enrich-api.md) - [All operations](https://skmtc.dev/companyenrich/apis/company-enrich-api/llms.txt) - [OpenAPI document](https://skmtc.dev/companyenrich/apis/company-enrich-api/revisions/07f84debab87?raw)