---
title: "Remove Company"
method: DELETE
path: "/companies"
---

# Remove Company

`DELETE /companies`

Lets you delete an existing company. The company and its associated sub-companies will go inactive. However, the customers associated with the company will still remain active.

## Query parameters

- `externalId` string
- `id` integer

## Response `200`

200

- object
  - `externalId` string
  - `companyId` integer
  - `name` string
  - `hierarchyDefinitionCode` string
  - `isActive` boolean
  - `extendedFields` object
    - `address1` string
    - `address2` string
    - `address3` string
    - `address4` string
    - `company_city` string
    - `company_country` string
    - `company_state` string
    - `industry` string
    - `owner` string
    - `phone` string
    - `pincode` string
  - `warnings` unknown[]
    - unknown

## Other responses

- `400` — 400

---

[API](https://skmtc.net/capillarytech/apis/sample-api.md) · [All operations](https://skmtc.net/capillarytech/apis/sample-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/capillarytech/sample-api/revisions/de241f2ed9b3/schema)