---
title: "Change company status"
method: POST
path: "/kyb/companies/{id}/change-status/"
tags: ["Companies"]
---

# Change company status

`POST /kyb/companies/{id}/change-status/`

## Request

- Base URL: `https://ivs.idenfy.com`
- URL: `https://ivs.idenfy.com/kyb/companies/{id}/change-status/`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/idenfy/apis/idenfy-ivs-core-api/docs/kyb/companies/:id/change-status/post.ts> (a function with typed inputs; its response is checked against the schema)

Note that the status cannot be changed from `PENDING` and `PROCESSING` statuses.

## Path parameters

- `id` string, required

## Request body

- union
  - NeedToStatusRequest
    - `status` 'PENDING' | 'PROCESSING' | 'NEED_TO_PROCESS' | 'NEED_TO_REVIEW' | 'COMPLETED'
  - NeedToStatusRequest
    - `status` 'PENDING' | 'PROCESSING' | 'NEED_TO_PROCESS' | 'NEED_TO_REVIEW' | 'COMPLETED'
  - CompletedStatusRequest
    - `status` 'PENDING' | 'PROCESSING' | 'NEED_TO_PROCESS' | 'NEED_TO_REVIEW' | 'COMPLETED'
    - `reviewInfo` union, required
      - ManualApproveRequest
        - `approvalStatus` 'APPROVED' | 'DENIED', required
      - ManualDenyRequest
        - `approvalStatus` 'APPROVED' | 'DENIED', required
        - `denyReason` string, nullable: The reason why this KYB form was denied.

## Response `200`

- union
  - NeedToStatus
    - `status` 'PENDING' | 'PROCESSING' | 'NEED_TO_PROCESS' | 'NEED_TO_REVIEW' | 'COMPLETED'
  - NeedToStatus
    - `status` 'PENDING' | 'PROCESSING' | 'NEED_TO_PROCESS' | 'NEED_TO_REVIEW' | 'COMPLETED'
  - CompletedStatus
    - `status` 'PENDING' | 'PROCESSING' | 'NEED_TO_PROCESS' | 'NEED_TO_REVIEW' | 'COMPLETED'
    - `reviewInfo` union, required
      - ManualApprove
        - `approvalStatus` 'APPROVED' | 'DENIED', required
        - `denyReason` string, nullable, required: The reason why this KYB form was denied.
      - ManualDeny
        - `approvalStatus` 'APPROVED' | 'DENIED', required
        - `denyReason` string, nullable: The reason why this KYB form was denied.

---

[API](https://skmtc.dev/idenfy/apis/idenfy-ivs-core-api.md) - [All operations](https://skmtc.dev/idenfy/apis/idenfy-ivs-core-api/llms.txt) - [OpenAPI document](https://skmtc.dev/idenfy/apis/idenfy-ivs-core-api/revisions/3540d9ee5506?raw)