type ContactIdvSessionDetail

Details of a contact's Plaid identity-verification session, fetched on demand from Plaid. The public graph exposes the timestamps, the captured selfie video, the captured identity documents, and the individual check outcomes; the remaining fields — including the raw Plaid pass-throughs they are derived from — are private-graph only.

FieldTypeDescription
statusContactIdvSessionStatus!

Where the verification as a whole stands. Success, Failed and PendingReview are all terminal and all carry captured identity; Active is still in progress, and Expired or Canceled never produced one.

createdAtDateTime!
completedAtDateTime
documents[ContactIdvDocument!]!

Captured identity documents, pulled out of documentary_verification: each document's category and its captured images.

selfieVideoUrlString

URL of the captured selfie video, pulled out of selfieCheck for direct access. Plaid-hosted and expiring; null when the template did not capture a selfie video.

nameMatchIdvMatchSummary

How the name that the contact supplied compared against Plaid's data sources. Null when the KYC step has not run.

dateOfBirthMatchIdvMatchSummary

How the date of birth compared against Plaid's data sources. Null when the KYC step has not run.

phoneNumberMatchIdvMatchSummary

How the phone number compared against Plaid's data sources. Null when the KYC step has not run.

addressMatchIdvMatchSummary

How the address compared against Plaid's data sources. Null when the KYC step has not run.

taxIdMatchIdvMatchSummary

How the tax id (SSN) compared against Plaid's data sources, from Plaid's id_number check. Null when the KYC step has not run.

livenessCheckIdvLivenessStatus

Whether the captured selfie passed liveness detection. Null when the selfie step has not run or captured no analysis.

facialComparisonCheckIdvFacialComparisonStatus

Whether the captured selfie matched the face on the identity document. Null when the selfie step has not run or captured no analysis.