---
title: "Companies - Bulk Identify and Update"
method: POST
path: "/v1/companies/bulk_identify"
---

# Companies - Bulk Identify and Update

`POST /v1/companies/bulk_identify`

## Headers

- `Content-Type` string
- `Accept` string
- `Authorization` string, required

## Request body

- object
  - `companies` object[]
    - `company_id` string, required — The unique identifier for the company
    - `metadata` object — Optional company metadata. You can add, remove, or modify any properties as needed for your use case.
      - `custom_company_property` string — example: Company name, Industry, etc.

## Response `202`

Accepted - Bulk identify

- object
  - `end_time` unknown
  - `file_size` integer
  - `filename` string
  - `job_id` string, uri
  - `links` string, style
  - `start_time` string
  - `status` 'queued' | 'validating' | 'processing' | 'pending_refresh' | 'completed' | 'failed'
  - `total_rows` integer
  - `type` string

---

[API](https://skmtc.net/userpilot/apis/userpilot-api.md) · [All operations](https://skmtc.net/userpilot/apis/userpilot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/userpilot/userpilot-api/versions/2b3a88b6a474/schema)