E-BGV- Search
Overview
E-BGV is a comprehensive electronic background verification (BGV) service tailored for fintechs, banks, and other organizations seeking to verify the identity and risk profile of employees or customers. By aggregating multiple data sources—ranging from PAN and EPFO records to telecom, email, court-case, and cybercrime databases—e-BGV delivers a consolidated risk score along with detailed sub-scores for each domain. Clients can use this information to make informed decisions during onboarding, lending, compliance checks, or periodic re-verifications.
API Description
API cURL
curl --location 'https://api.signzy.app/api/v3/ebgv/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_AUTH_TOKEN>' \
--data-raw '{
"phoneNumber": "",
"name": "",
"fatherName": "",
"email": "",
"pan": "",
"Address": "",
"dob": "",
"gender": "",
"matchType": "exact",
"employment": "",
"strictness": "",
"callbackUrl": ""
}'
Input Table
Field | Type / Format | Allowed / Example Values | Description | Required |
|---|---|---|---|---|
phoneNumber | Integer | 9876543210 | Customer’s primary contact. | Yes |
name | string | "Rohit Kumar" | Full legal name appearing on ID. | Yes |
fatherName | string | "Satish Kumar" | Father / guardian name used in KYC forms. | Yes |
string | No | |||
pan | string | "ABCDE1234F" | Indian Permanent Account Number (letters-digits-letter). | No |
address | string | "221B Baker St,\nBengaluru, KA 560001" | Full residential or business address as supplied. | Yes |
dob | String DD-MM-YYYY | "01-01-2000" | Date of birth (ISO-8601). | No |
gender | string | "male", "female" | Self-declared gender identifier. | No |
matchType | string | "exact" | "possible" | Result of internal identity-match algorithm. | Yes |
employment | string | True/False, by default False | Employment check | No |
strictness | string | strict,moderate, lenient, by default strict | Confidence threshold used when running the check | No |
callBack | string | "https://api.partner.com/webhook" | Optional endpoint to receive async status updates. | No |
Output Parameters
Parameter | Description / Format |
|---|---|
requestId | String |
Output Response
{
"requestId": ""
}Status Code
HTTP Codes | Explanation |
|---|---|
200 | ok |
400 | Incorrect Input |
401 | Authentication Failed |
409 | Upstream Error |
500 | Some Error occured at our side please try again later |