Address Match
POST
https://api.staging.indiconnect.in/idverifygr/verification
Last modified:2026-04-03 06:52:02
match score, match status, and parsed address components for both input addresses.
Request Headers
| Header | Description |
|---|---|
myAppId | Application identifier used for service authentication |
service-key | Unique service key provided for accessing the verification service |
Authorization | API authorization credentials for secure access |
Content-Type | Specifies the request payload format (application/json) |
Request Parameters
| Parameter | Type | Description |
|---|---|---|
address1 | String | First address to be compared |
address2 | String | Second address to be compared |
documentType | String | Specifies the verification type (address match) |
Response Fields
| Field | Description |
|---|---|
ok | Indicates whether the request was successful (true / false) |
message | Status message describing the result |
result.score | Matching score between the two addresses (0 to 1 scale) |
result.match | Indicates whether the addresses are considered a match |
result.address1.house | Extracted house or primary component from address1 |
result.address1.state | Extracted state from address1 |
result.address2.house | Extracted house or primary component from address2 |
result.address2.district | Extracted district from address2 |
result.address2.state | Extracted state from address2 |
result.address2.pin | Extracted PIN code from address2 |
error | Contains error details if the request fails |
Use Cases
- KYC and customer identity verification
- Address deduplication and validation
- Fraud detection through address mismatch
- Data standardization and cleansing
Key Benefits
- Accurate address matching with scoring
- Structured extraction of address components
- Improves data quality and consistency
- Easy integration for real-time validation
Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.staging.indiconnect.in/idverifygr/verification' \
--header 'myAppId: verification_v3_app' \
--header 'service-key: sk_test_a9944179bc598f06' \
--header 'Authorization: x-api-access indc_test_a41eaf2a175f3b13:ac_test_bf7117f6da6c6285' \
--header 'Content-Type: application/json' \
--data-raw '{
"query": "mutation AddressMatch {\r\n verify(\r\n input: {\r\n documentType: \"address match\"\r\n address1: \"SR NO\"\r\n address2: \"ROAD NO-3, SR NO-52 411015\"\r\n }\r\n ) {\r\n ok\r\n message\r\n result {\r\n __typename\r\n ... on AddressMatchResult {\r\n score\r\n match\r\n address1 {\r\n house\r\n state\r\n }\r\n address2 {\r\n house\r\n district\r\n state\r\n pin\r\n }\r\n }\r\n }\r\n error {\r\n message\r\n }\r\n }\r\n}\r\n",
"variables": {}
}'Response Response Example
200 - Success - Success
{
"data": {
"verify": {
"ok": true,
"message": "Verification completed successfully",
"result": {
"__typename": "AddressMatchResult",
"score": 0.71,
"match": false,
"address1": {
"house": "SR NO",
"state": ""
},
"address2": {
"house": "SURVEY NO 52",
"district": "PUNE",
"state": "MAHARASHTRA",
"pin": 411015
}
},
"error": null
}
}
}Modified at 2026-04-03 06:52:02