> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://www.truework.com/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://www.truework.com/docs/_mcp/server.

# Verification Request State Change

POST 

This webhook will be issued when a verification request in an order changes state. A `completed` state indicates that new data is now available on the order. A `canceled` state indicates that a verification was not able to be completed, but may have applicant-provided information and/or documents.

Reference: https://www.truework.com/docs/api-reference/webhooks/events/verification-request-state-change

## Request

### Payload

- `version` (string, optional) — The version of the webhook payload
- `hook` (VerificationRequestStateChangePostPayloadContentApplicationJsonSchemaHook, optional)
- `data` (VerificationRequestStateChangePostPayloadContentApplicationJsonSchemaData, optional)

## Types

### VerificationRequestStateChangePostPayloadContentApplicationJsonSchemaHook

- `id` (integer, optional) — The ID of the webhook
- `event` (enum, optional) — The event that triggered the webhook
  - Allowed values: `verification_request.state.change`
- `target` (string, optional) — The target of the webhook
- `triggered_at` (datetime, optional) — Date and time of the event that triggered the webhook

### VerificationRequestStateChangePostPayloadContentApplicationJsonSchemaData

- `order_id` (string, optional) — The ID of the order that contains the verification request
- `state` (enum, optional)
  - Allowed values: `pending-approval`, `processing`, `action-requred`, `completed`, `canceled`, `invalid`
- `verification_request_id` (string, optional) — The ID of the verification request
- `credentials_session_token` (string, optional) — The ID of the Truework Direct session
- `metadata` (VerificationRequestStateChangePostPayloadContentApplicationJsonSchemaDataMetadata, optional)

### VerificationRequestStateChangePostPayloadContentApplicationJsonSchemaDataMetadata