---
title: "Reject applicant"
method: POST
path: "/resources/applicants/{applicantId}/-/reject"
---

# Reject applicant

`POST /resources/applicants/{applicantId}/-/reject`

## Request

- Base URL: `https://api.sumsub.com`
- URL: `https://api.sumsub.com/resources/applicants/{applicantId}/-/reject`
- Auth: API key in header `X-App-Token`
- TypeScript: <https://skmtc.dev/sumsub/apis/sumsub-api/docs/resources/applicants/:applicantId/-/reject/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `applicantId` string, required

## Request body

- object
  - `note` string: Optional note text providing additional context for the applicant profile. Notes can be added and managed either in the Dashboard or via [dedicated API methods](ref:add-applicant-note).
  - `tags` string[]: [Tags](ref:add-custom-applicant-tags) that you may want to assign to the applicant profile. Each string represents a standalone tag. <br><br>⚠️ Mind that tag names are case sensitive.
  - `reasons` object, required: Contains nested arrays, where each array represents a predefined reason category and includes predefined reason strings.
    - `fraud` string[]: Covers cases where the applicant intentionally tries to deceive the system or commit identity fraud. Refer to the [Reason List](ref:external-rejection-reasons-list#fraud-group) for available reasons.
    - `finance` string[]: Covers financial risks and payment-related fraud. Refer to the [Reason List](ref:external-rejection-reasons-list#finance-group) for available reasons.
    - `regulation` string[]: Covers legal and compliance-related violations. Refer to the [Reason List](ref: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](ref:external-rejection-reasons-list#abuse-group) for available reasons.
    - `device` string[]: Covers risks associated with applicant devices. Refer to the [Reason List](ref: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](ref:external-rejection-reasons-list#manual-group) for available reasons.

---

[API](https://skmtc.dev/sumsub/apis/sumsub-api.md) - [All operations](https://skmtc.dev/sumsub/apis/sumsub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sumsub/apis/sumsub-api/revisions/fcc702e558a2?raw)