---
title: "Update companies in batch"
method: PUT
path: "/v2/company"
tags: ["Company"]
---

# Update companies in batch

`PUT /v2/company`

## Request body

- Company[]
  - `account_status` 'APPROVED' | 'BLOCKED' | 'CLOSED' | 'PENDING' | 'REJECTED' — The account status for the related person at that timestamp. Refer to the Developer Guide "Entity Account Statuses" to understand what account statuses mean at Cable, and how to use them
  - `addresses` object[]
    - `address` Address — Legal/contact address for the entity
      - `city` string
      - `country` string
      - `county` string
      - `lines` string[]
      - `postal_code` string
      - `state` string
    - `type` string — Type of address. eg. Registered, Trading, Legal
  - `company_id` string, required — Unique external identifier of the company entity, ID stored in your database / back-office
  - `email` string — Main contact email for the company
  - `first_transaction_completed_at` string, date-time — Original timestamp of when the person completed their first transaction
  - `incorporation_country` string — 2 or 3 Character ISO 3166 Country Code (https://w.wiki/4rY)
  - `incorporation_date` string, date — Date when the company was incorporated
  - `incorporation_state` string — State where the company was incorporated (US only)
  - `industry` string — Nature of business
  - `industry_classification` object
    - `code` string[], required — Industry classification codes
    - `code_type` string, required — Type of industry classification code
    - `description` string — Description of the industry classification code
  - `is_test_company` boolean, required — If the company is a test company, this should be set to true
  - `legal_name` string — Legal name of the business
  - `phone_number` string — Main contact telephone number for the company
  - `primary_operation_country` string — 2 or 3 Character ISO 3166 Country Code (https://w.wiki/4rY)
  - `product_type` string
  - `registered_as_inactive` boolean — If the company is registered as inactive, this should be set to true
  - `registration_number` object
    - `type` string, required — Type of registration number, e.g. Companies House number (UK), EIN number (US) etc.
    - `value` string, required — The registration number
  - `source_of_funds` string — Source of initial deposit of the company
  - `source_of_wealth` string — Source of wealth of the company
  - `timestamp` string, date-time, required — When this company record was created or last modified in your system, in ISO 8601 format.
  - `trading_name` string — Trading name of the business
  - `type` string — Business entity type. eg. Sole Trader, Limited Company

## Response `200`

Batch processing result

- WriteOperationResponse
  - `message` string, required — Provides additional information about the operation result.
  - `organization_id` string, required — The organization ID for which the operation was performed.
  - `success` boolean, required — Indicates if the write operation was successful.
  - `write_count` integer, required — The number of records written to the database.

## Other responses

- `400` — Invalid company data in batch
- `401` — Unauthorized request
- `404` — Company not found in batch
- `429` — Rate limit exceeded
- `500` — Server error
- `default` — General error

---

[API](https://skmtc.dev/cable/apis/cable-api.md) · [All operations](https://skmtc.dev/cable/apis/cable-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cable/cable-api/revisions/3222cd28dba5/schema)