---
title: "Batch companies delete"
method: DELETE
path: "/people/2/companies/batch"
tags: ["customer-engagement", "people", "company-profile"]
---

# Batch companies delete

`DELETE /people/2/companies/batch`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/people/2/companies/batch`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`
  - API key in header `Authorization`
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Use this method to delete multiple companies.<br>**NOTE** Array size of the batch delete request is limited to `1000` companies.

## Request body

- 62d9ebafb4f8a59174952b52d2134c8b74a981fb89910acb47a5dc3a9064656eBatchDeleteRequest
  - `companies` 62d9ebafb4f8a59174952b52d2134c8b74a981fb89910acb47a5dc3a9064656eBatchDeleteEntry[]: List of companies.
    - `query` F844b0afac35672d98ce1343ef10d571c4af0fe8a10110acace5c340f3fe0877CompanyIdentityQuery
      - `id` string: Company ID
      - `externalId` string: Company external ID
      - `name` string: Company name
      - `domain` string: Company domain

## Response `200`

successful response

- 62d9ebafb4f8a59174952b52d2134c8b74a981fb89910acb47a5dc3a9064656eBatchDeleteResponse
  - `results` 62d9ebafb4f8a59174952b52d2134c8b74a981fb89910acb47a5dc3a9064656eBatchDeleteResult[]: List of any unsuccessful result from the batch operation for each processed entry. Example, name used in the request already exists.
    - `errors` 3206ab1528b990358dc5d8da723b52b5db6e1d582712d39b5ed66ac5c4b1e84fBatchOperationError[]: List of errors
      - `message` string: Error message
    - `query` object: Query used for company identification
    - `status` integer: HTTP status

## Other responses

- `207`: successful response
- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error
- `4XX`: Error responses
- `5XX`: Error responses

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)