Sumsub Know Your Customer (KYC) Integration Guide
5. Proof of Address Behavior
Sumsub treats address verification as one PROOF_OF_RESIDENCE step. For this level, there are two possible paths.
Identity Document Satisfies PoA
When the linked PoA preset allows it, certain identity documents can satisfy proof of address without a separate upload. This is common for identity documents that show a printed residential address, such as some driver's licenses.
Integration Rule
- 1Upload the identity document first.
- 2Call
GET /resources/applicants/{applicantId}/requiredIdDocsStatus. - 3If
PROOF_OF_RESIDENCEis already satisfied, skip the dedicated PoA upload.
Dedicated PoA Document Upload
If PROOF_OF_RESIDENCE remains unsatisfied after identity upload, upload a separate document using API idDocType: UTILITY_BILL.
{
"idDocType": "UTILITY_BILL",
"country": "DEU"
}UTILITY_BILL is the API label for the dedicated PoA upload slot. It does not mean only electricity or water bills are accepted. The linked PoA preset determines which real-world document categories pass verification.
5.1 PoA Document Categories That May Be Enabled in the Preset
| Category Detected in Check Results | Possible Subtypes | Examples |
|---|---|---|
| Government organization | statementvoterRegistrationtaxBillother | Benefit letters, tax assessments, voter registration, vehicle registration. |
| Utility provider | utilityBilltelecomother | Electricity, water, gas, heating, internet, landline TV bills. |
| Bank | bankStatementbankLetterother | Bank statements, bank correspondence, mortgage statements. |
| Mobile operator | Category-level option | Mobile phone bills, if enabled. |
| Other | leaseother | Employer address letters, rental agency bills, signed lease agreements. |
After verification, GET /resources/checks/latest?type=POA&applicantId={id} may return poaCheckInfo.companyContact with the detected category and subtype.
Next steps
Continue to KYC Results for how GREEN and RED outcomes are delivered and interpreted after verification completes.