Skip to main content

Proof of Address

Preview

PROOF_OF_ADDRESS:v1 is in preview. The output data block schema may change before general availability.

Headless address document verification that extracts residential address data​

Verifies an address document using static evidence collected by your own front end and submitted to IDnow via API, with results delivered as a ResidentialAddress data block.

In Headless mode, your application is responsible for collecting and providing the document image. IDnow performs verification on this static input using automated analysis and data extraction modules. There is no user-facing capture step; all evidence is provided directly by your system.

Key features​

  • Customer-managed evidence collection – The customer application captures and submits document images via API.
  • Residential address extraction – Full address, street, city, postal code, country, and state are extracted from the document.
  • Optional identity cross-check – When compareIdentity is enabled, the document holder's identity is validated against a prior BasicIdentity step.
  • Unified Verification data block – A Verification result is produced on all output routes.
Step compatibility

PROOF_OF_ADDRESS:v1, IBAN_VERIFICATION:v1, and Document-based IDV Headless steps each require a different document type and cannot be combined in the same flow.

Configuration​

ParameterTypeRequiredDescription
configObjectYesEnvironment-specific configuration.
config.live.realmStringYesThe IDCheck.io realm used for document processing in the live environment.
config.staging.realmStringYesThe IDCheck.io realm used for document processing in the staging environment.
compareIdentityBooleanNoWhen true, requires a prior BasicIdentity step for identity cross-check. Default: false.

Input data blocks​

Data block typeRequiredDescription
DocumentImagesYesContains vault references ({ "$ref": "vault", "$id": "<uuid>" }) to the address document images. Front side is required; back side is optional.
BasicIdentityWhen compareIdentity: trueIdentity data used for cross-check against the document holder.

Routes​

RouteDescription
verifiedDocument was successfully processed and address data was extracted.
not_verifiedDocument was rejected or analysis flagged the document as invalid.
fraud_detectedFraudulent identity suspicion detected. Takes precedence over other failure conditions.

Output data blocks​

Data block typeRouteDescription
ResidentialAddressverifiedStreet, city, postal code, and country extracted from document.
VerificationAll routesVerification result with status, checks, and evidence.

Supported countries and issuers​

Address documents are supported for the following countries and issuers. Depending on the specific document model, analysis may be fully automated or involve a manual review step.

CountryISO codeIssuerCategory
AustriaAUTZMRAdministration
AustriaAUTWIEN_ENERGIEEnergy supplier
AustriaAUTA1_TELEKOMTelecom mobile
AustriaAUTDREI_AUSTRIATelecom mobile
BelgiumBELLUMINUSEnergy supplier
BelgiumBELTELENETTelecom
BelgiumBELVOOTelecom
GermanyDEUBERLINERWASSERWater supplier
GermanyDEUEONEnergy supplier
GermanyDEUO2Telecom
GermanyDEUTTELECOMTelecom
GermanyDEUVATTENFALLEnergy supplier
GermanyDEUVODAFONETelecom
GermanyDEUONE_AND_ONETelecom
FranceFRAEDFEnergy supplier
FranceFRAENGIEEnergy supplier
FranceFRATOTAL_DIRECT_ENERGIEEnergy supplier
FranceFRATOTAL_ENERGIESEnergy supplier
FranceFRADIRECT_ENERGIEEnergy supplier
FranceFRAENIEnergy supplier
FranceFRAVATTENFALLEnergy supplier
FranceFRAOCTOPUS_ENERGYEnergy supplier
FranceFRAILEKEnergy supplier
FranceFRAOHM_ENERGIEEnergy supplier
FranceFRASOWEEEnergy supplier
FranceFRAMINT_ENERGIEEnergy supplier
FranceFRAALPIQEnergy supplier
FranceFRAELMYEnergy supplier
FranceFRAEKWATEUREnergy supplier
FranceFRAGAZ_DE_BORDEAUXEnergy supplier
FranceFRAPLENITUDEEnergy supplier
FranceFRAPRIMEOEnergy supplier
FranceFRAENERGIE_STRASBOURGEnergy supplier
FranceFRADYNEFFEnergy supplier
FranceFRAENERCOOPEnergy supplier
FranceFRAANTARGAZEnergy supplier
FranceFRAALTERNAEnergy supplier
FranceFRALA_BELLENERGIEEnergy supplier
FranceFRAUEMEnergy supplier
FranceFRAURBAN_SOLAR_ENERGYEnergy supplier
FranceFRABUTAGAZEnergy supplier
FranceFRAHAPPEEnergy supplier
FranceFRAWEKIWIEnergy supplier
FranceFRAPAPERNESTEnergy supplier
FranceFRAENGIE_PROEnergy supplier
FranceFRAORANGETelecom
FranceFRASFRTelecom
FranceFRAFREETelecom
FranceFRANUMERICABLETelecom
FranceFRACANALBOXTelecom
FranceFRANORDNETTelecom
FranceFRABOUYGUESTelecom
FranceFRABOUYGUES_MOBILETelecom mobile
FranceFRASFR_MOBILETelecom mobile
FranceFRAFREE_MOBILETelecom mobile
FranceFRAORANGE_MOBILETelecom mobile
FranceFRALA_POSTE_MOBILETelecom mobile
FranceFRANRJ_MOBILETelecom mobile
FranceFRACIC_MOBILETelecom mobile
FranceFRACREDIT_MUTUEL_MOBILETelecom mobile
FranceFRAAUCHAN_TELECOMTelecom mobile
FranceFRAWIZZEETelecom mobile
FranceFRAPRIXTELTelecom mobile
FranceFRALEBARATelecom mobile
FranceFRASYMA_MOBILETelecom mobile
FranceFRAREGLO_MOBILETelecom mobile
FranceFRACORIOLISTelecom mobile
FranceFRAYOUPRICETelecom mobile
FranceFRACDISCOUNT_MOBILETelecom mobile
FranceFRAZEOPTelecom mobile
FranceFRASAURWater supplier
FranceFRASUEZWater supplier
FranceFRAVEOLIAWater supplier
FranceFRADIONEOWater supplier
FranceFRADGFIPFiscal administration
FranceFRACPAMAdministration
FranceFRAREVOLUTBank
FranceFRATWISPAYBank
FranceFRAMAIFInsurer
IrelandIRLBANK_OF_IRELANDBank
IrelandIRLELECTRIC_IRELANDEnergy supplier
IrelandIRLSKY_TVTelecom
ItalyITAENELEnergy supplier
ItalyITAFASTWEBTelecom
ItalyITATIMTelecom
LuxembourgLUXCTIEAdministration
MonacoMCOSMEGEnergy supplier
NetherlandsNLDABN_AMROBank
NetherlandsNLDZIGGOTelecom
NetherlandsNLDVANDEBRONEnergy supplier
NetherlandsNLDVITENSWater supplier
PortugalPRTEDPEnergy supplier
PortugalPRTNOSTelecom
PortugalPRTMEOTelecom
PortugalPRTEPALWater supplier
RomaniaROUDIGITelecom
RomaniaROUENELEnergy supplier
RomaniaROUENGIEEnergy supplier
RomaniaROUEONEnergy supplier
RomaniaROUGOLD_ENERGIEEnergy supplier
RomaniaROUENDESAEnergy supplier
RomaniaROUORANGETelecom
RomaniaROUINGBank
RomaniaROURAIFFEISEN_BANKBank
SpainESPIBERDROLAEnergy supplier
SpainESPJAZZTELTelecom
SpainESPMOVISTARTelecom

For the full list of supported document models, contact your account manager.