Digital Address Verification
Last updated
Was this helpful?
Last updated
Was this helpful?
The Digital Address Verification product is a solution designed to verify customer address using their id numbers and utility numbers. This product is especially beneficial for businesses that want to ensure the legitimacy of the address information provided by my customers for improved service delivery and risk management. The service is currently available in Nigeria, and South Africa.
Only available via the . There is only one asynchronous endpoint available that allows for efficiency and ability to handle network delays better.
You can evaluate the Digital Address Verification product in Sandbox by utilizing the test data provided below:
South Africa
Joe Doe Leo
0000000000000
Nigeria
Joe Doe Leo
0000000000
There are four simulated results to test your integration:
0 e.g 00000000
Varies based on searched address and full name matching
Varies based on searched address and full name matching
1 e.g 000000001
Verification failed: Unique identifier type
not found.
1013
2 e.g 000000002
Invalid id or utility number format
2413
3 e.g 00000003
Database unavailable
1015
4 e.g 00000004
Simulating when addresses are too far apart.
1022
Asynchronous Endpoint
Endpoint v2/async-verify-address
Method: POST
Description: This endpoint allows you to verify an address asynchronously. It is less prone to network related issues.
This section provides a detailed overview of the endpoint for Digital Address verification.
smileid-partner-id
Your Smile ID partner ID.
002
smileid-request-signature
A signature to authenticate the request.
sample-signature
smileid-timestamp
The timestamp of the request.
2024-07-30T19:16:56.426Z
smileid-source-sdk
The source SDK identifier.
rest_api
smileid-source-sdk-version
The version of the source SDK.
1.0.0
200
Success
{ "success": true }
400
Bad request
{ "success": false, "code": "2413", "error": "Invalid request" }
500
Internal server error
{ "success": false, "error": "System Error" }
1012
Verification successful.
All checks are fine
1022
Verification failed: No address found within acceptable distance.
All addresses too far
1022
Verification failed: Provided name does not match name in records.
Full name doesn't match
1017
Warning: Address within acceptable distance, but information is outdated.
All addresses last updated date less than 6 months ago
1013
Verification failed: Unique identifier type
not found.
Unique identifier is not found in the database
1015
Service unavailable: Data source is down, please try again later.
The verification could not be completed because the ID authority was unavailable.
This endpoint verifies a address asynchronously.
002
sample-signature
2024-07-30T19:16:56.426Z
sample-source
0.0.1
https://webhook.site/c5b9a01f-f224-494a-86b8-39ffe0c292a4
ZA
cape town
Joe Doe
123456789
123456789
test provider