Name Match
POST
https://api.staging.indiconnect.in/idverifygr/verification
Last modified:2026-04-03 06:56:58
It helps organizations validate identity information by determining whether two names belong to the same individual or entity.
matching score and result indicating whether the names match.
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 |
|---|---|---|
name1 | String | First name to be compared |
name2 | String | Second name to be compared |
documentType | String | Specifies the verification type (Name Match) |
Response Fields
| Field | Description |
|---|---|
ok | Indicates whether the request was successful (true / false) |
message | Status message describing the result |
result.result.requestId | Unique identifier for the verification request |
result.result.statusCode | Status code indicating the result of the verification |
result.result.result.score | Matching score between the two names (0 to 1 scale, where 1 is exact match) |
result.result.result.result | Boolean value indicating whether the names match (true / false) |
error | Contains error details if the request fails |
Use Cases
- KYC and identity verification
- Name validation across multiple documents
- Fraud detection and prevention
- Data deduplication and cleansing
Key Benefits
- Accurate name matching with scoring
- Supports real-time identity verification
- Reduces risk of fraud and duplication
- Easy integration for automated workflows
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_v1' \
--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 {\r\n verify(\r\n input: {\r\n name1: \"tushar\",\r\n name2: \"tushar\",\r\n documentType:\"Name Match\",\r\n }\r\n ) {\r\n ok\r\n message\r\n result {\r\n ... on NameMatchResult {\r\n result\r\n }\r\n }\r\n error {\r\n status\r\n message\r\n decryptedError\r\n }\r\n }\r\n}\r\n",
"variables": {}
}'Response Response Example
{
"data": {
"verify": {
"ok": true,
"message": "Verification completed successfully",
"result": {
"result": {
"requestId": "29a5959e-227f-4328-a269-56f812e84031",
"result": {
"score": 1,
"result": true
},
"statusCode": 101
}
},
"error": null
}
}
}Modified at 2026-04-03 06:56:58