Aadhaar Verification

10 min

Introduction

Aadhaar Verification API is designed to simplify identity verification processes for seamless customer onboarding. This versatile tool empowers businesses to validate Aadhaar numbers and access comprehensive demographic information effortlessly.

With just a simple input of an Aadhaar number, our API swiftly returns a wealth of data. You gain instant access to the Aadhaar number's validity status, age band, gender, state, and a masked mobile number associated with the holder. This invaluable information enables you to verify customer identities accurately and efficiently, enhancing your overall customer experience and bolstering fraud prevention measures.

We prioritize data security and privacy. Our API strictly adheres to the regulations and privacy standards established by UIDAI. As a testament to our commitment, the API provides a masked version of the mobile number, protecting user privacy and preventing unauthorized access.

The Aadhaar Verification API caters to businesses of all sizes, from startups to large enterprises. By integrating this API into your systems, you can streamline your customer onboarding, KYC (Know Your Customer), and identity verification processes. Whether you operate in the financial sector, e-commerce, or any industry that requires reliable identity verification, our API is designed to meet your needs.

API Details

Endpoint:

POST https://api.signzy.app/api/v3/aadhar/verify-aadhar

POST https://api-preproduction.signzy.app/api/v3/aadhar/verify-aadhar

Request body parameters:

Parameter	Data Type	Description	Required
uid	string	The 12-digit Aadhaar number to be verified.	Yes

{
    "uid":"<Aadhaar number>"
}

Request Headers:

Name	Value	Required	Description
Authorization	XXXXXXXXXX	Yes	An authentication token to authorize the request. Reach out to the Signzy support team to get one created.
Content-Type	application/json	Yes	The type of content that the request body contains.

Code samples:

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api-preproduction.signzy.app/api/v3/aadhar/verify-aadhar"
  method := "POST"

  payload := strings.NewReader(`{
    "uid":"<Aadhaar number>"
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "{{access-token}}")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Response Body parameters:

Parameter	Data Type	Description
result	object	The Response Object
result.verified	string	The verification status associated with the Aadhaar number
result.ageBand	string	The age band of the Aadhaar number holder
result.state	string	State associated with the Aadhaar number
result.mobileNumber	string	The masked mobile number associated with the Aadhar number
result.gender	string	The gender of the Aadhaar number holder

{
    "url": {},
    "id": "649855d4bb90f6003f19e503",
    "result": {
        "verified": "true",
        "ageBand": "20-30",
        "state": "Haryana",
        "mobileNumber": "*******484",
        "gender": "MALE"
    },
    "instance": {}
}

Performance Percentiles:

Percentile	Response Time (in milliseconds)
90
95
99