---
title: "Reject applicant action"
method: POST
path: "/resources/api/applicantActions/{actionId}/-/reject"
---

# Reject applicant action

`POST /resources/api/applicantActions/{actionId}/-/reject`

## Path parameters

- `actionId` string, required

## Request body

- object
  - `note` string — Optional note text providing additional context for the applicant action.
  - `tags` string[] — [Custom tags](https://cockpit.sumsub.com/checkus/sdkIntegrations/globalSettings/general/tags) that you may want to assign to the applicant action. Each string represents a standalone tag.<br><br>⚠️ Tag names are case sensitive.
  - `reasons` object, required — Contains nested arrays, where each array represents a predefined reason category and includes predefined reason strings. ⚠️ If `reasons` is omitted, set to `null`, or contains no populated category lists, a `400 Bad Request` response is returned.
    - `fraud` string[] — Covers cases where the applicant intentionally tries to deceive the system or commit identity fraud. Refer to the [Reason List](https://docs.sumsub.com/sumsub/reference/external-rejection-reasons-list#fraud-group) for available reasons.
    - `finance` string[] — Covers financial risks and payment-related fraud. Refer to the [Reason List](https://docs.sumsub.com/sumsub/reference/external-rejection-reasons-list#finance-group) for available reasons.
    - `regulation` string[] — Covers legal and compliance-related violations. Refer to the [Reason List](https://docs.sumsub.com/sumsub/reference/external-rejection-reasons-list#regulation-group) for available reasons.
    - `abuse` string[] — Covers violations of platform rules or misuse of services. Refer to the [Reason List](https://docs.sumsub.com/sumsub/reference/external-rejection-reasons-list#abuse-group) for available reasons.
    - `device` string[] — Covers risks associated with applicant devices. Refer to the [Reason List](https://docs.sumsub.com/sumsub/reference/external-rejection-reasons-list#device-group) for available reasons.
    - `manual` string[] — Covers cases where the final decision was made by the risk or compliance team. Refer to the [Reason List](https://docs.sumsub.com/sumsub/reference/external-rejection-reasons-list#manual-group) for available reasons.

## Response `200`

---

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