PAN verification

Introduction

Our PAN Verification API offers a reliable and straightforward way to verify Permanent Account Numbers (PAN). By submitting a few details like name and PAN number, users can quickly ascertain the authenticity and status of any PAN. This API is perfect for businesses that require secure and accurate PAN verification for financial transactions, compliance, and customer onboarding. With a focus on simplicity and precision, our API ensures a seamless verification process.

API details

Endpoint

POST https://api.signzy.app/api/v3/pan/verifications

POST https://api-preproduction.signzy.app/api/v3/pan/verifications

Request Headers

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

Request body parameters

Parameter	Data Type	Description	Required
name	string	The name associated with the PAN number.	Mandatory
number	string	The PAN (Permanent Account Number) to be verified.	Mandatory
fuzzy	string	Indicates whether fuzzy matching should be applied. "true" if you prefer the FUZZY match. "false" if you want an EXACT match. The default value for this flag is set to "true".	Optional
panStatus	string	Indicates whether the PAN status should be checked. "true" if you want PAN status details else "false".	Optional

{
    "name": "Raunak Singh",
    "number": "XXXXX0000X",
    "fuzzy": "true",
    "panStatus": "true"
}

Code samples

package main

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

func main() {

  url := "https://api-preproduction.signzy.app/api/v3/pan/verifications"
  method := "POST"

  payload := strings.NewReader(`{
    "name": "Raunak Singh",
    "number": "XXXXX0000X",
    "fuzzy": "true",
    "panStatus": "true"
}`)

  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", "<your Auth Key>")

  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	An object containing the verification result.
result.verified	Boolean	Indicates whether the verification was successful."true" if "name" in input matches with "upstreamName" in Result else "false".
result.message	String	A message describing the result of the verification process.
result.upstreamName	String	Name of the individual on the PAN card.
result.panStatus	String	The status of the PAN. (Refer to PAN status codes below for possible responses). This is returned only when "panStatus" is given as "true" in input.
result.panStatusCode	String	A code representing the PAN status. (Refer to PAN status codes below for possible responses). This is returned only when "panStatus" is given as "true" in input.

{
    "error": {
        "reason": "Error From Upstream",
        "status": 409,
        "message": "Upstream Down",
        "type": "Conflict",
        "statusCode": 409,
        "name": "error"
    }
}

PAN status codes

Status Code	Pan Status
E	VALID
F	FAKE
X	DEACTIVATED
D	DELETED
N	INVALID
EA	AMALGAMATION
EC	ACQUISITION
ED	DEATH
EI	DISSOLUTION
EL	LIQUIDATED
EM	MERGER
EP	PARTITION
ES	SPLIT
EU	UNDER LIQUIDATION

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!