IDCanopy Developers
IDCanopy APIKYC

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

FieldRequiredDescription
identity.firstNameyes
identity.lastNameyes
identity.birthDateyesYYYY/MM/DD
identity.nationalIdno
address.streetyes
address.postalCodeyes
address.cityyes
address.countryCodeyes
address.houseNumber / building / district / provinceno
phone.phoneNumberno

Response

FieldTypeNotes
globalResult.totalScoreintegerEnum 0, 50, 75, 100
resultDetails[]arrayPer 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 /auth and a server-side or allowed origin. In the browser, use Mock.

On this page