2×2 KYC
Data-based identity and address verification against independent sources
Verify identity without a document upload
2×2 KYC is the data-based route to personal identification. Submit the person's identity and address and compare them with independent data sources, rather than asking the person to photograph a document. It can support an onboarding journey where suitable source coverage is available.
The IDCanopy KYC overview describes three routes: document-based verification, data verification and reuse of an existing identity. This page covers data verification. For the other routes, see Document Verification and AIS Ident.
What it returns
A per-datasource match result for a submitted identity and address, plus an aggregate score. Inspect the returned evidence against your verification policy: the API schema does not define a fixed number of sources, a guaranteed coverage level or a universal score threshold for a 2×2 decision.
Request
POST /identity/verify
| Field | Required | Description |
|---|---|---|
identity.firstName | yes | |
identity.lastName | yes | |
identity.birthDate | yes | YYYY/MM/DD |
identity.nationalId | no | |
address.street | yes | |
address.postalCode | yes | |
address.city | yes | |
address.countryCode | yes | |
address.houseNumber / building / district / province | no | |
phone.phoneNumber | no |
Response
| Field | Type | Notes |
|---|---|---|
globalResult.totalScore | integer | Enum 0, 50, 75, 100 |
resultDetails[] | array | Per datasource: datasource, country, matches[] (record, match: full/partial/not-present) |
Decision
The caller decides from globalResult.totalScore and the per-record match values in
resultDetails. A successful HTTP response means the call succeeded, not that the person's identity
has met your policy. Do not interpret the numeric score as a count of independent sources.
Test cases
Test cases are not available yet. Contact IDCanopy: office@idcanopy.com.
Reference
The operations of this topic and the token call. The full Umbrella API reference has every topic.
Send request against Production or Sandbox needs a bearer token from
POST /authand a server-side or allowed origin. In the browser, use Mock.