---
title: "Terminate providers"
method: PATCH
path: "/v2/providers/terminate-providers"
tags: ["v2/providers"]
---

# Terminate providers

`PATCH /v2/providers/terminate-providers`

Terminate providers.

## Headers

- `organization-id` string

## Request body

- TerminateProviderV2Dto
  - `provider_ids` string[], required — Provider ids to be terminated in comma separated strings within the array.
  - `reason` string, required — Reason for the termination.
  - `filters` FilterProvidersV2Dto, required
    - `offset` number — The starting index for pagination, specifying how many records to skip.
    - `limit` number — The maximum number of records to retrieve in a single request.
    - `file_type` 'Clean' | 'Non_Clean' | 'Pending' — File Type of the providers to filter by to be terminated.
    - `flagged` boolean — Flagged providers will be terminated.
    - `start_updated_at` string, date-time — Filter providers that are created or updated >= specified date.
    - `end_updated_at` string, date-time — Filter providers that are created or updated < specified date.

## Response `204`

Providers successfully terminated.

- object
  - `message` string

## Other responses

- `207` — Some providers couldn't be terminated. The response includes each failed provider id followed by the reason of the failure.
- `400` — Bad request because the wrong parameters are provided in the request body.
- `401` — Unauthorized if authorization token is not provided or invalid.
- `403` — Forbidden if user access is not right.

---

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