---
title: "Deactivate a company"
method: DELETE
path: "/companies/{id}"
tags: ["Companies"]
---

# Deactivate a company

`DELETE /companies/{id}`

**Plan: Paid API.**

Soft-deletes (deactivates) the company and returns its final state.

## Response `200`

Deactivated.

- Company — Full company as returned by show/create/update. `createdAt`/`updatedAt` here are localized display strings, unlike the ISO timestamps on the list endpoint.
  - `id` string, uuid
  - `accountId` string, uuid
  - `name` string
  - `legalName` string, nullable
  - `status` string, nullable
  - `active` boolean
  - `posted` boolean
  - `taxable` boolean
  - `legacyType` string, nullable — e.g. Customer, Vendor.
  - `primaryEmail` string, nullable
  - `primaryPhone` string, nullable
  - `primaryPhoneExt` string, nullable
  - `phoneWithExt` string, nullable
  - `website` string, nullable
  - `facebook` string, nullable
  - `twitter` string, nullable
  - `creditLimitInDollars` number, nullable — US dollars.
  - `discount` number, nullable
  - `markup` number, nullable
  - `currency` string, nullable
  - `currencySymbol` string, nullable
  - `rate` number, nullable
  - `accountNumber` string, nullable
  - `licenceNumber` string, nullable
  - `tollFreeNumber` string, nullable
  - `taxExemptCode` string, nullable
  - `taxExemptExpirationDate` string, date, nullable
  - `backgroundInfo` string, nullable
  - `otherInfo` string, nullable
  - `specialNotes` string, nullable
  - `localFilePath` string, nullable
  - `doNotCall` boolean
  - `stopSupply` boolean
  - `enableCustomerPortal` boolean
  - `enableJobBoardView` boolean
  - `enableCustomerPortalOrdering` boolean
  - `enableWebStore` boolean
  - `notesCount` integer
  - `assetsCount` integer
  - `tasksCount` integer
  - `allowDelete` boolean
  - `termCodeId` string, uuid, nullable
  - `termCodeName` string, nullable
  - `salesTaxId` string, uuid, nullable
  - `leadSourceId` string, uuid, nullable
  - `leadSourceName` string, nullable
  - `categoryName` string, nullable
  - `pricingLevelId` string, uuid, nullable
  - `pricingLevelName` string, nullable
  - `primaryContactId` string, uuid, nullable
  - `apContactId` string, uuid, nullable
  - `createdById` string, uuid, nullable
  - `updatedById` string, uuid, nullable
  - `createdAt` string
  - `updatedAt` string
  - `primaryContact` NamedRef — Lightweight reference to a related record.
    - `id` string, uuid
    - `name` string
  - `apContact` NamedRef — Lightweight reference to a related record.
    - `id` string, uuid
    - `name` string
  - `leadSource` NamedRef — Lightweight reference to a related record.
    - `id` string, uuid
    - `name` string
  - `marketingArea` NamedRef — Lightweight reference to a related record.
    - `id` string, uuid
    - `name` string
  - `group` NamedRef — Lightweight reference to a related record.
    - `id` string, uuid
    - `name` string
  - `category` NamedRef — Lightweight reference to a related record.
    - `id` string, uuid
    - `name` string
  - `pricingLevel` NamedRef — Lightweight reference to a related record.
    - `id` string, uuid
    - `name` string
  - `createdBy` NamedRef — Lightweight reference to a related record.
    - `id` string, uuid
    - `name` string
  - `updatedBy` NamedRef — Lightweight reference to a related record.
    - `id` string, uuid
    - `name` string
  - `tax` object
    - `id` string, uuid
    - `name` string
    - `rate` number
    - `taxRate` number
    - `rateInPercent` string
  - `salesReps` Party[]
    - `id` string, uuid
    - `name` string, nullable
    - `initials` string, nullable
  - `companySalesReps` object[]
    - `companySalesRepId` string, uuid
    - `companyId` string, uuid
    - `id` string, uuid — User id.
    - `accountId` string, uuid
    - `name` string, nullable
  - `contacts` object[]
    - `id` string, uuid
    - `name` string
    - `title` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `ext` string, nullable
    - `phoneWithExt` string, nullable
  - `addresses` Address[]
    - `id` string
    - `addressType` string, nullable
    - `name` string, nullable
    - `nameStreet` string, nullable
    - `nameStreetCity` string, nullable
    - `street` string, nullable
    - `street1` string, nullable
    - `suburb` string, nullable
    - `city` string, nullable
    - `zip` string, nullable
    - `state` string, nullable
    - `country` string, nullable
    - `attentionTo` string, nullable
    - `coordinates` object
      - `latitude` number, nullable
      - `longitude` number, nullable
  - `emails` Email[]
    - `id` string
    - `email` string
    - `emailType` string, nullable
  - `phones` Phone[]
    - `id` string
    - `phone` string
    - `ext` string, nullable
    - `phoneType` string, nullable
    - `phoneWithExt` string, nullable
  - `companyDivisionsTitle` string, nullable
  - `companyDivisions` NamedRef[]
    - `id` string, uuid
    - `name` string

## Other responses

- `401` — Missing/expired credentials, an index request without a required filter, or the plan does not include this endpoint.

---

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