---
updatedAt: 2026-09-29T08:29:34.000Z
agentTools:
  projectIndex: https://docs.sumsub.com/llms.txt
---

# Reset applicant profile

# Overview

Use this method to roll the [applicant review status](https://docs.sumsub.com/sumsub/reference/get-applicant-review-status#review-statuses) back to `init` (**Documents requested**). In effect, it means that documents uploaded by the applicant are marked as inactive and all statuses previously assigned are deleted.

Using this endpoint can be quite beneficial in scenarios where an applicant makes a support request to re-pass verification from scratch with new documents. This might be necessary if the applicant’s previous documents are outdated, incorrect, or if there have been significant changes in the applicant data that require re-verification.

<Callout icon="❗️" theme="error">
  ### Warning

  Avoid resetting applicants with a [final rejection](https://docs.sumsub.com/sumsub/reference/rejected). Such cases may involve restricted countries or potentially fraudulent applicants.
</Callout>

<Callout icon="🚧" theme="warn">
  ### Attention

  - You cannot reset applicants that are currently being checked and are in `pending`, `queued`, or `prechecked` review status.
  - Let us know if you are going to use this method, as we may be able to suggest a better flow for your case.
</Callout>

<Callout icon="📘" theme="info">
  ### Note

  The [Change applicant status to init](https://docs.sumsub.com/sumsub/reference/change-applicant-status-to-init) method also returns the applicant to `init` but is only intended for `onHold` cases with at least one grey **Requested** step. It allows to request missing documents without resetting previously uploaded files or completed steps.
</Callout>

<Callout icon="😀" theme="default">
  ### Did you know?

  You can also [reset an applicant profile](https://docs.sumsub.com/sumsub/docs/reset-applicant-profile) from the Dashboard.
</Callout>

# Required permissions

To use this method, your [app token](https://docs.sumsub.com/sumsub/docs/app-tokens) must have the **Reset applicants** [permission](https://docs.sumsub.com/sumsub/docs/user-roles#permissions).

# Request example

```curl
curl -X POST \
     'https://api.sumsub.com/resources/applicants/5d6f821b0a975a0b8aa00000/reset' \
     -H 'X-App-Token: <your-app-token>' \
     -H 'X-App-Access-Sig: <your-signature>' \
     -H 'X-App-Access-Ts: <unix-timestamp>'
```

# Response explained

If the request is successfully sent and processed, you will get the following response:

```json
{
  "ok": 1
}
```

If the request fails, you will receive an HTTP response containing an error code along with a message explaining the error.

For example:

```json
{
  "description": "Invalid id '12313213'",
  "code": 400,
  "correlationId": "36d4c16cd06b6f673976b30000000000"
}
```

<Callout icon="👍" theme="okay">
  ### Tip

  You can trace the applicant profile has been reset in the [Events](https://docs.sumsub.com/sumsub/docs/review-results-in-applicant-profile#review-profile-events) section of the applicant page in the Dashboard.
</Callout>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "sumsub-api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.sumsub.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "name": "X-App-Token",
        "in": "header",
        "x-default": ""
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/resources/applicants/{applicantId}/reset": {
      "post": {
        "summary": "Reset applicant profile",
        "description": "",
        "operationId": "reset-applicant",
        "parameters": [
          {
            "name": "applicantId",
            "in": "path",
            "description": "Unique applicant identifier in the Sumsub system. <br><br>This identifier is a random combination of 24 digits and lowercase Latin characters. It is automatically generated when the applicant is created on the Sumsub side, and can be found in the [Dashboard](https://cockpit.sumsub.com/checkus/#/applicants/individual?limit=10&page=0). <br><br>If the `applicantId` is unknown to you, use the [Get applicant data (externalUserId)](https://docs.sumsub.com/sumsub/reference/get-applicant-data-via-externaluserid) method to fetch it.",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```