# Verification status changed

Our system sends the “Verification status changed” callback when a user completes and submits a form. Please note that this callback is sent with the `verification_status` parameter set to `pending`.

Enable in the Dashboard first
The callback must be enabled in the Dashboard for a specific form before use. For instructions, see [Using the “Verification status changed” callback](/guides/form-integration#using-the-verification_status_changed-callback).

## Schema

```json
{
  "$ref": "#/components/schemas/verification-status-changed-api",
  "components": {
    "schemas": {
      "applicant_id": {
        "title": "Applicant ID",
        "type": "string",
        "minLength": 36,
        "maxLength": 36,
        "example": "723f46ab04feb64f442946f2953a67eaecf7",
        "description": "A unique identifier of an applicant, that is assigned by our system after an applicant object was created with a “Create an applicant” request"
      },
      "verification_status--1": {
        "title": "Verification status",
        "type": "string",
        "example": "unused",
        "description": "Verification status, that indicates the current state of a verification process\n- `unused`: a user has not completed the form\n- `pending`: the verification is in progress\n- `completed`: the verification has been successfully completed\n"
      },
      "external_applicant_id": {
        "title": "External applicant ID",
        "type": [
          "string",
          "null"
        ],
        "minLength": 0,
        "maxLength": 50,
        "example": "cb1eebbe-9945-4e64-8f60-c920f1e3e237",
        "description": "A unique identifier of your user in your system"
      },
      "form_id": {
        "title": "Form ID",
        "type": [
          "string",
          "null"
        ],
        "minLength": 36,
        "maxLength": 36,
        "example": "d87132ba092d8148ba1891736832d0451ac2",
        "description": "A unique identifier of a form, assigned by our system after it is created in the Dashboard"
      },
      "form_token": {
        "title": "Form token",
        "type": "string",
        "minLength": 36,
        "maxLength": 36,
        "example": "7505262b02bb0145c62a04d969eacedb4873",
        "description": "A unique token for a form, generated by our system, and included as part of a form URL"
      },
      "verification_id": {
        "title": "Verification ID",
        "type": [
          "string",
          "null"
        ],
        "minLength": 36,
        "maxLength": 36,
        "example": "d2177cdf067d424a221b5d045dc616bf81f9",
        "description": "A unique identifier for a verification, assigned by our system after a verification is created using the “Create a verification\" request"
      },
      "verification_attempts_left": {
        "title": "Verification attempts left",
        "type": [
          "integer",
          "null"
        ],
        "format": "number",
        "example": 5,
        "description": "A number of verification attempts available for a user, set in form settings in the Dashboard. A `null` value means “not limited”. It equals `0` if set in the settings"
      },
      "request_id": {
        "title": "Request ID",
        "type": "string",
        "minLength": 36,
        "maxLength": 36,
        "example": "5eb27e030be7f24a7f19c794926f1d2f2abc",
        "description": "A unique identifier for a callback request, assigned by our system after a callback is automatically created by our system after an event occurs"
      },
      "verification-status-changed-api": {
        "type": "object",
        "title": "VERIFICATION_STATUS_CHANGED",
        "properties": {
          "type": {
            "type": "string",
            "example": "VERIFICATION_STATUS_CHANGED"
          },
          "applicant_id": {
            "$ref": "#/components/schemas/applicant_id"
          },
          "verification_status": {
            "allOf": [
              {
                "$ref": "#/components/schemas/verification_status--1"
              },
              {
                "example": "pending"
              }
            ]
          },
          "external_applicant_id": {
            "$ref": "#/components/schemas/external_applicant_id"
          },
          "form_id": {
            "$ref": "#/components/schemas/form_id"
          },
          "form_token": {
            "$ref": "#/components/schemas/form_token"
          },
          "verification_id": {
            "$ref": "#/components/schemas/verification_id"
          },
          "verification_attempts_left": {
            "$ref": "#/components/schemas/verification_attempts_left"
          },
          "request_id": {
            "$ref": "#/components/schemas/request_id"
          }
        }
      }
    }
  }
}
```

## Example

```json
{
  "type": "VERIFICATION_STATUS_CHANGED",
  "verification_status": "pending",
  "applicant_id": "aa6ca3a10440624d671b9ef4771c32cb9d3a",
  "external_applicant_id": "",
  "form_id": "24148eb10810e24b2c1afaa4b9759008d352",
  "form_token": "d2177cdf067d424a221b5d045dc616bf81f9",
  "verification_id": "270128a807f3c24bfb1b8da4a4af7d2080c4",
  "verification_attempts_left": null,
  "request_id": "5eb27e030be7f24a7f19c794926f1d2f2abc"
}
```