---
title: "Changes to Create a new Identity Verification"
method: POST
path: "/identity_verification/create"
---

# Changes to Create a new Identity Verification

`POST /identity_verification/create`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 19 of 55 revisions.

- **2026-10-15** `ea443cd78f6f`: 1 info
- **2026-10-02** `e07a869352e8`: 1 info
- **2026-07-22** `94406d9a4d27`: 1 info
- **2026-07-22** `a1bbca018160`: 1 info
- **2026-06-25** `80d23bfdc2e5`: 1 warning, 3 info
- **2026-06-10** `fb8c3f188d8b`: 10 breaking, 35 info
- **2026-02-17** `cd6c86bfb523`: 1 info
- **2025-12-11** `465584b48c99`: 1 info
- **2025-11-12** `f8b9f1a85767`: 2 info
- **2025-08-13** `7fc793bb9e85`: 2 info
- **2025-07-16** `bb819dcb75b3`: 2 info
- **2025-03-05** `c95815496d92`: 1 info
- **2025-01-15** `5dbeedb71831`: 14 info
- **2024-11-14** `b0263533029b`: 2 info
- **2024-10-09** `36052f62cce1`: 2 info
- **2024-09-04** `a2c34406c317`: 11 info
- **2024-06-18** `be701ec93161`: 4 breaking, 3 info
- **2024-03-11** `ec7541420dd2`: 112 warning
- **2024-02-21** `5de70cc1e6ca`: 17 breaking, 28 warning, 113 info

## Changes

- **2026-10-15** `ea443cd78f6f`: 1 info
  - added the required property `kyc_check/id_number/ssa_verification` to the response with the `200` status
- **2026-10-02** `e07a869352e8`: 1 info
  - added the new optional request property `language`
- **2026-07-22** `94406d9a4d27`: 1 info
  - response property `beacon_user_id` deprecated
- **2026-07-22** `a1bbca018160`: 1 info
  - added the new optional request property `user/ip_address`
- **2026-06-25** `80d23bfdc2e5`: 1 warning, 3 info
  - added the new `in_epic` enum value to the `user/id_number/type` response property for the response status `200`
  - added the new `in_epic` enum value to the request property `user/id_number/type`
  - added the optional property `selfie_check/selfies/items/analysis/age_check` to the response with the `200` status
  - added the required property `risk_check/email/name` to the response with the `200` status
- **2026-06-10** `fb8c3f188d8b`: 10 breaking, 35 info
  - the `documentary_verification/documents/items/analysis/fraud_analysis_details/detail_check` response's property type changed from `string` to no type for status `200`
  - the `documentary_verification/documents/items/analysis/fraud_analysis_details/image_composition_check` response's property type changed from `string` to no type for status `200`
  - the `documentary_verification/documents/items/analysis/fraud_analysis_details/integrity_check` response's property type changed from `string` to no type for status `200`
  - the `documentary_verification/documents/items/analysis/fraud_analysis_details/issue_date_check` response's property type changed from `string` to no type for status `200`
  - the `documentary_verification/documents/items/analysis/fraud_analysis_details/portrait_details_check` response's property type changed from `string` to no type for status `200`
  - the `documentary_verification/documents/items/analysis/fraud_analysis_details/portrait_presence_check` response's property type changed from `string` to no type for status `200`
  - the `documentary_verification/documents/items/analysis/fraud_analysis_details/type_supported` response's property type changed from `string` to no type for status `200`
  - the `documentary_verification/documents/items/analysis/image_quality_details/blur_check` response's property type changed from `string` to no type for status `200`
  - the `documentary_verification/documents/items/analysis/image_quality_details/dimensions_check` response's property type changed from `string` to no type for status `200`
  - the `documentary_verification/documents/items/analysis/image_quality_details/glare_check` response's property type changed from `string` to no type for status `200`
  - added `#/components/schemas/FraudCheckOutcome` to the `documentary_verification/documents/items/analysis/fraud_analysis_details/detail_check` response property `allOf` list for the response status `200`
  - added `#/components/schemas/FraudCheckOutcome` to the `documentary_verification/documents/items/analysis/fraud_analysis_details/image_composition_check` response property `allOf` list for the response status `200`
  - added `#/components/schemas/FraudCheckOutcome` to the `documentary_verification/documents/items/analysis/fraud_analysis_details/integrity_check` response property `allOf` list for the response status `200`
  - added `#/components/schemas/FraudCheckOutcome` to the `documentary_verification/documents/items/analysis/fraud_analysis_details/portrait_details_check` response property `allOf` list for the response status `200`
  - added `#/components/schemas/FraudCheckOutcome` to the `documentary_verification/documents/items/analysis/fraud_analysis_details/portrait_presence_check` response property `allOf` list for the response status `200`
  - added `#/components/schemas/FraudCheckOutcome` to the `documentary_verification/documents/items/analysis/fraud_analysis_details/type_supported` response property `allOf` list for the response status `200`
  - added `#/components/schemas/FraudCheckOutcomeWithNoData` to the `documentary_verification/documents/items/analysis/fraud_analysis_details/issue_date_check` response property `allOf` list for the response status `200`
  - added `#/components/schemas/ImageQualityOutcome` to the `documentary_verification/documents/items/analysis/image_quality_details/blur_check` response property `allOf` list for the response status `200`
  - added `#/components/schemas/ImageQualityOutcome` to the `documentary_verification/documents/items/analysis/image_quality_details/dimensions_check` response property `allOf` list for the response status `200`
  - added `#/components/schemas/ImageQualityOutcome` to the `documentary_verification/documents/items/analysis/image_quality_details/glare_check` response property `allOf` list for the response status `200`
  - the response property `documentary_verification/documents/items/analysis/fraud_analysis_details` became required for the status `200`
  - the response property `documentary_verification/documents/items/analysis/image_quality_details` became required for the status `200`
  - removed the `failed` enum value from the `documentary_verification/documents/items/analysis/fraud_analysis_details/detail_check` response property for the response status `200`
  - removed the `failed` enum value from the `documentary_verification/documents/items/analysis/fraud_analysis_details/image_composition_check` response property for the response status `200`
  - removed the `failed` enum value from the `documentary_verification/documents/items/analysis/fraud_analysis_details/integrity_check` response property for the response status `200`
  - removed the `failed` enum value from the `documentary_verification/documents/items/analysis/fraud_analysis_details/issue_date_check` response property for the response status `200`
  - removed the `failed` enum value from the `documentary_verification/documents/items/analysis/fraud_analysis_details/portrait_details_check` response property for the response status `200`
  - removed the `failed` enum value from the `documentary_verification/documents/items/analysis/fraud_analysis_details/portrait_presence_check` response property for the response status `200`
  - removed the `failed` enum value from the `documentary_verification/documents/items/analysis/fraud_analysis_details/type_supported` response property for the response status `200`
  - removed the `failed` enum value from the `documentary_verification/documents/items/analysis/image_quality_details/blur_check` response property for the response status `200`
  - removed the `failed` enum value from the `documentary_verification/documents/items/analysis/image_quality_details/dimensions_check` response property for the response status `200`
  - removed the `failed` enum value from the `documentary_verification/documents/items/analysis/image_quality_details/glare_check` response property for the response status `200`
  - removed the `no_data` enum value from the `documentary_verification/documents/items/analysis/fraud_analysis_details/issue_date_check` response property for the response status `200`
  - removed the `success` enum value from the `documentary_verification/documents/items/analysis/fraud_analysis_details/detail_check` response property for the response status `200`
  - removed the `success` enum value from the `documentary_verification/documents/items/analysis/fraud_analysis_details/image_composition_check` response property for the response status `200`
  - removed the `success` enum value from the `documentary_verification/documents/items/analysis/fraud_analysis_details/integrity_check` response property for the response status `200`
  - removed the `success` enum value from the `documentary_verification/documents/items/analysis/fraud_analysis_details/issue_date_check` response property for the response status `200`
  - removed the `success` enum value from the `documentary_verification/documents/items/analysis/fraud_analysis_details/portrait_details_check` response property for the response status `200`
  - removed the `success` enum value from the `documentary_verification/documents/items/analysis/fraud_analysis_details/portrait_presence_check` response property for the response status `200`
  - removed the `success` enum value from the `documentary_verification/documents/items/analysis/fraud_analysis_details/type_supported` response property for the response status `200`
  - …5 more
- **2026-02-17** `cd6c86bfb523`: 1 info
  - added the required property `risk_check/trust_index_score` to the response with the `200` status
- **2025-12-11** `465584b48c99`: 1 info
  - added the required property `risk_check/facial_duplicates` to the response with the `200` status
- **2025-11-12** `f8b9f1a85767`: 2 info
  - added the optional property `latest_scored_protect_event` to the response with the `200` status
  - added the required property `documentary_verification/documents/items/extracted_data/issue_date` to the response with the `200` status
- **2025-08-13** `7fc793bb9e85`: 2 info
  - the response property `user_id` became required for the status `200`
  - added the required property `documentary_verification/documents/items/analysis/aamva_verification` to the response with the `200` status
- **2025-07-16** `bb819dcb75b3`: 2 info
  - added the new optional request property `user_id`
  - added the optional property `user_id` to the response with the `200` status
- **2025-03-05** `c95815496d92`: 1 info
  - added the optional property `documentary_verification/documents/items/analysis/human_review` to the response with the `200` status
- **2025-01-15** `5dbeedb71831`: 14 info
  - added the optional property `documentary_verification/documents/items/analysis/fraud_analysis_details` to the response with the `200` status
  - added the optional property `documentary_verification/documents/items/analysis/image_quality_details` to the response with the `200` status
  - added the optional property `risk_check/behavior/risk_level` to the response with the `200` status
  - added the optional property `risk_check/devices/items/factors` to the response with the `200` status
  - added the optional property `risk_check/devices/items/risk_level` to the response with the `200` status
  - added the optional property `risk_check/email/factors` to the response with the `200` status
  - added the optional property `risk_check/email/risk_level` to the response with the `200` status
  - added the optional property `risk_check/identity_abuse_signals/stolen_identity/risk_level` to the response with the `200` status
  - added the optional property `risk_check/identity_abuse_signals/synthetic_identity/first_party_synthetic_fraud` to the response with the `200` status
  - added the optional property `risk_check/identity_abuse_signals/synthetic_identity/risk_level` to the response with the `200` status
  - added the optional property `risk_check/identity_abuse_signals/synthetic_identity/third_party_synthetic_fraud` to the response with the `200` status
  - added the optional property `risk_check/network` to the response with the `200` status
  - added the optional property `risk_check/phone/factors` to the response with the `200` status
  - added the optional property `risk_check/phone/risk_level` to the response with the `200` status
- **2024-11-14** `b0263533029b`: 2 info
  - added the required property `beacon_user_id` to the response with the `200` status
  - added the required property `verify_sms` to the response with the `200` status
- **2024-10-09** `36052f62cce1`: 2 info
  - added the optional property `selfie_check/selfies/items/analysis/facial_analysis` to the response with the `200` status
  - added the required property `selfie_check/selfies/items/analysis/liveness_check` to the response with the `200` status
- **2024-09-04** `a2c34406c317`: 11 info
  - added the optional property `documentary_verification/documents/items/extracted_data/name` to the response with the `200` status
  - added the optional property `kyc_check/address/city` to the response with the `200` status
  - added the optional property `kyc_check/address/international_details` to the response with the `200` status
  - added the optional property `kyc_check/address/postal_code` to the response with the `200` status
  - added the optional property `kyc_check/address/region` to the response with the `200` status
  - added the optional property `kyc_check/address/street` to the response with the `200` status
  - added the optional property `kyc_check/date_of_birth/day` to the response with the `200` status
  - added the optional property `kyc_check/date_of_birth/month` to the response with the `200` status
  - added the optional property `kyc_check/date_of_birth/year` to the response with the `200` status
  - added the optional property `kyc_check/name/family_name` to the response with the `200` status
  - added the optional property `kyc_check/name/given_name` to the response with the `200` status
- **2024-06-18** `be701ec93161`: 4 breaking, 3 info
  - the `client_user_id` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `documentary_verification/documents/items/extracted_data/address/country` response property's minLength was decreased from `2` to `0` for the response status `200`
  - the `documentary_verification/documents/items/extracted_data/issuing_country` response property's minLength was decreased from `2` to `0` for the response status `200`
  - the `user/address/country` response property's minLength was decreased from `2` to `0` for the response status `200`
  - the `client_user_id` request property's minLength was decreased from `1` to `0`
  - the `user/address/country` request property's minLength was decreased from `2` to `0`
  - the `user/client_user_id` request property's minLength was decreased from `1` to `0`
- **2024-03-11** `ec7541420dd2`: 112 warning
  - added the new `aboutme` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `aboutme` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `adobe` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `adobe` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `adult_sites` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `adult_sites` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `altbalaji` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `altbalaji` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `archiveorg` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `archiveorg` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `atlassian` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `atlassian` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `bitmoji` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `bitmoji` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `bodybuilding` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `bodybuilding` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `bukalapak` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `bukalapak` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `codecademy` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `codecademy` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `deliveroo` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `deliveroo` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `diigo` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `diigo` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `disneyplus` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `disneyplus` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `duolingo` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `duolingo` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `envato` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `envato` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `eventbrite` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `eventbrite` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `evernote` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `evernote` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `firefox` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `firefox` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `flipkart` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `flipkart` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - added the new `freelancer` enum value to the `risk_check/email/linked_services/items/` response property for the response status `200`
  - added the new `freelancer` enum value to the `risk_check/phone/linked_services/items/` response property for the response status `200`
  - …72 more
- **2024-02-21** `5de70cc1e6ca`: 17 breaking, 28 warning, 113 info
  - removed the enum value `in_epic` of the request property `user/id_number/type`
  - the `client_user_id` request property's minLength was increased from `0` to `1`
  - the `user/address/country` request property's minLength was increased from `0` to `2`
  - the `user/client_user_id` request property's minLength was increased from `0` to `1`
  - removed the required property `beacon_user_id` from the response with the `200` status
  - removed the required property `documentary_verification/documents/items/analysis/aamva_verification` from the response with the `200` status
  - removed the required property `documentary_verification/documents/items/analysis/fraud_analysis_details` from the response with the `200` status
  - removed the required property `documentary_verification/documents/items/analysis/image_quality_details` from the response with the `200` status
  - removed the required property `documentary_verification/documents/items/extracted_data/issue_date` from the response with the `200` status
  - removed the required property `risk_check/email/includes_date_of_birth` from the response with the `200` status
  - removed the required property `risk_check/email/is_edu` from the response with the `200` status
  - removed the required property `risk_check/email/name` from the response with the `200` status
  - removed the required property `risk_check/facial_duplicates` from the response with the `200` status
  - removed the required property `risk_check/trust_index_score` from the response with the `200` status
  - removed the required property `selfie_check/selfies/items/analysis/liveness_check` from the response with the `200` status
  - removed the required property `user_id` from the response with the `200` status
  - removed the required property `verify_sms` from the response with the `200` status
  - removed the request property `user_id`
  - removed the optional property `documentary_verification/documents/items/analysis/human_review` from the response with the `200` status
  - removed the optional property `documentary_verification/documents/items/extracted_data/name` from the response with the `200` status
  - removed the optional property `kyc_check/address/city` from the response with the `200` status
  - removed the optional property `kyc_check/address/international_details` from the response with the `200` status
  - removed the optional property `kyc_check/address/postal_code` from the response with the `200` status
  - removed the optional property `kyc_check/address/region` from the response with the `200` status
  - removed the optional property `kyc_check/address/street` from the response with the `200` status
  - removed the optional property `kyc_check/date_of_birth/day` from the response with the `200` status
  - removed the optional property `kyc_check/date_of_birth/month` from the response with the `200` status
  - removed the optional property `kyc_check/date_of_birth/year` from the response with the `200` status
  - removed the optional property `kyc_check/name/family_name` from the response with the `200` status
  - removed the optional property `kyc_check/name/given_name` from the response with the `200` status
  - removed the optional property `latest_scored_protect_event` from the response with the `200` status
  - removed the optional property `risk_check/behavior/risk_level` from the response with the `200` status
  - removed the optional property `risk_check/devices/items/factors` from the response with the `200` status
  - removed the optional property `risk_check/devices/items/risk_level` from the response with the `200` status
  - removed the optional property `risk_check/email/factors` from the response with the `200` status
  - removed the optional property `risk_check/email/risk_level` from the response with the `200` status
  - removed the optional property `risk_check/identity_abuse_signals/stolen_identity/risk_level` from the response with the `200` status
  - removed the optional property `risk_check/identity_abuse_signals/synthetic_identity/first_party_synthetic_fraud` from the response with the `200` status
  - removed the optional property `risk_check/identity_abuse_signals/synthetic_identity/risk_level` from the response with the `200` status
  - removed the optional property `risk_check/identity_abuse_signals/synthetic_identity/third_party_synthetic_fraud` from the response with the `200` status
  - …118 more

---

[Operation](https://skmtc.dev/plaid/apis/the-plaid-api/docs/identity_verification/create/post.md) - [API](https://skmtc.dev/plaid/apis/the-plaid-api.md) - [Page](https://skmtc.dev/plaid/apis/the-plaid-api/changes/identity_verification/create/post)
