E-BGV

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

1.) Initiate

curl --location 'https://api-preproduction.signzy.app/api/v3/initiate/ebgv' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_AUTH_TOKEN>' \
--data-raw '{
  "name": "",
  "pan": "",
  "aadhar": "",
  "phone": "",
  "emailId": "",
  "fatherName": "",
  "dateOfBirth": "",
  "presentAddress": "",
  "permanentAddress": "",
  "callbackUrl": ""
}'

Output Response

{
    "result": {
        "requestId": "EBGV17794509189767P79ZS***",
        "message": "E-BGV request accepted and processing initiated"
    },
    "reason": "Request Successful",
    "code": "S001"
}

2.) result

curl --location 'https://api-preproduction.signzy.app/api/v3/result/ebgv' \
--header 'Content-Type: application/json' \
--header 'Authorization: **' \
--data '{
    "requestId": "EBGV17794509189767P79ZS***"
  }'

{
  "result": {
    "requestId": "",
    "overallStatus": "",
    "checks": [
      {
        "checkName": "pan",
        "status": "",
        "providerResponse": {
          "name": "",
          "number": "",
          "firstName": "",
          "middleName": "",
          "lastName": "",
          "typeOfHolder": "",
          "gender": "",
          "isIndividual": "",
          "category": "",
          "dateOfBirth": "",
          "maskedAadhaarNumber": "",
          "emailId": "",
          "mobileNumber": "",
          "aadhaarLinked": "",
          "address": {
            "fullAddress": "",
            "addressLineOne": "",
            "addressLineTwo": "",
            "street": "",
            "city": "",
            "state": "",
            "pincode": "",
            "country": ""
          },
          "panStatus": "",
          "panStatusCode": "",
          "isValid": ""
        },
        "impact": "",
        "nameMatch": "",
        "nameMatchScore": ""
      },
      {
        "checkName": "epfo",
        "status": "",
        "providerResponse": {
          "uan": [
            ""
          ],
          "summary": {
            "recentEmployerData": {
              "establishmentName": "",
              "establishmentId": "",
              "memberId": "",
              "dateOfExit": "",
              "dateOfJoining": "",
              "leaveReason": "",
              "employerConfidenceScore": "",
              "matchingUan": ""
            },
            "matchingUan": "",
            "isEmployed": "",
            "employeeNameMatch": "",
            "employerNameMatch": "",
            "uanCount": "",
            "dateOfExitMarked": ""
          },
          "uanDetails": {
            "": {
              "basicDetails": {
                "gender": "",
                "dateOfBirth": "",
                "employeeConfidenceScore": "",
                "name": "",
                "mobile": "",
                "aadhaarVerificationStatus": ""
              },
              "employmentDetails": {
                "establishmentName": "",
                "establishmentId": "",
                "memberId": "",
                "dateOfExit": "",
                "dateOfJoining": "",
                "leaveReason": "",
                "employerConfidenceScore": ""
              }
            }
          },
          "uanSource": [
            {
              "uan": "",
              "source": ""
            }
          ],
          "nameDobFilteringScore": ""
        },
        "impact": "",
        "nameMatch": "",
        "nameMatchScore": ""
      },
      {
        "checkName": "courtCase",
        "status": "",
        "providerResponse": {
          "status": "",
          "total": "",
          "cases": []
        },
        "impact": "",
        "nameMatch": "",
        "nameMatchScore": ""
      },
      {
        "checkName": "fir",
        "status": "",
        "providerResponse": {
          "message": "",
          "numResults": "",
          "status": "",
          "total": "",
          "cases": []
        },
        "impact": "",
        "nameMatch": "",
        "nameMatchScore": ""
      },
      {
        "checkName": "cyberCrime",
        "status": "",
        "providerResponse": {
          "phoneNumber": "",
          "email": "",
          "upiId": "",
          "bankAccountNumber": "",
          "socialMediaLink": ""
        },
        "impact": ""
      },
      {
        "checkName": "cyberFraud",
        "status": "",
        "providerResponse": {},
        "impact": ""
      },
      {
        "checkName": "phoneIntel",
        "status": "",
        "providerResponse": {
          "customerName": "",
          "alternateNumber": "",
          "isValid": "",
          "subscriberStatus": "",
          "connectionType": "",
          "currentServiceProvider": "",
          "originalServiceProvider": "",
          "networkRegion": "",
          "isPorted": ""
        },
        "impact": "",
        "nameMatch": "",
        "nameMatchScore": ""
      },
      {
        "checkName": "digitalIdentityScore",
        "status": "",
        "providerResponse": {
          "digitalIdentityScore": "",
          "phoneNameDIScore": "",
          "digitalFootprint": "",
          "ecomFootprint": "",
          "socialFootprint": "",
          "travelFootprint": "",
          "qcomFootprint": "",
          "businessNameFound": "",
          "ageBand": "",
          "gender": "",
          "firstNameMatch": "",
          "lastNameMatch": "",
          "nameMatchScore": "",
          "phoneFirstSeenYear": "",
          "emailFirstSeenYear": "",
          "phoneEmailFirstSeenYear": "",
          "phoneEmailLastSeenYear": "",
          "phoneNameFirstSeenYear": "",
          "phoneNameLastSeenYear": "",
          "emailNameFirstSeenYear": "",
          "emailNameLastSeenYear": ""
        },
        "impact": "",
        "nameMatch": "",
        "nameMatchScore": ""
      },
      {
        "checkName": "emailVerification",
        "status": "",
        "providerResponse": {
          "emailId": "",
          "validEmail": "",
          "status": "",
          "freeEmail": "",
          "didYouMean": "",
          "domain": "",
          "account": "",
          "domainAgeDays": "",
          "smtpProvider": "",
          "mxFound": "",
          "mxRecord": "",
          "personalDetails": {
            "name": ""
          },
          "companyDetails": {
            "name": "",
            "domain": ""
          }
        },
        "impact": ""
      }
    ],
    "completedChecks": "",
    "totalChecks": "",
    "lastUpdatedAt": ""
  },
  "reason": "Request successful",
  "code": "S001"
}

3.). fetch

curl --location 'https://api-preproduction.signzy.app/api/v3/status/ebgv' \
--header 'Content-Type: application/json' \
--header 'Authorization: **' \
--data '{
    "requestId": "EBGV17794509189767P79ZS***"
  }'

{
    "result": {
        "requestId": "EBGV17794509189767P79Z***",
        "status": "completed",
        "completedChecks": 9,
        "totalChecks": 9,
        "lastUpdatedAt": "2026-05-22T12:06:42.286Z"
    },
    "reason": "Request successful",
    "code": "S001"
}

Status Codes

httpCode	code	Reason
200	S001	Request Successful
200	S003	Data not found
400	E001	Bad request
401	E101	Unauthorized access
403	E201	Forbidden
404	E301	Data not found
409	E401	Upstream error
429	E501	Rate limit exceeded
500	E601	Internal server error
503	E701	Service unavailable
504	E801	Timeout

Contact Us for Any Assistance

If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!