Signature Extraction API

12 min

Introduction

This API extracts the signature from the given PAN card.This is useful for comparing the signature on the PAN with the actual signature during the KYC process.

How to call the API

Before going for Auto extraction or Verification calls, you first need to create an Identity object. For best results, please make sure that the image you use fits tightly in camera view and is horizontally-aligned. Each image/pdf should be less than 2MB

Though this engine support extraction of images as well as pdf files, our test results indicate that there is much better accuracy and faster response time for image extraction. We would suggest you to pass only image file for better results.

API Input Guidelines

PAN Card extraction system accepts direct URL to the front sides.

Step 1: Hit Identities API

Sample cURL

Preproduction

Production

curl --location --request POST
 '<https://preproduction.signzy.tech/api/v2/patrons/<Patron> ID>/identities' \
--header 'Connection: keep-alive' \
--header 'Authorization: <Auth Key>' \
--header 'Content-Type: application/json' \
--header 'Accept-Language: en-GB,en-US;q=0.9,en;q=0.8' \
--data-raw '{
    "type": "individualPan",
    "email": "<email Id>",
    "callbackUrl": "<https://www.w3schools.com",>
    "essentials": {<images Url>}
}'

curl --location --request POST
 '<https://signzy.tech/api/v2/patrons/<Patron> ID>/identities' \
--header 'Connection: keep-alive' \
--header 'Authorization: <Auth Key>' \
--header 'Content-Type: application/json' \
--header 'Accept-Language: en-GB,en-US;q=0.9,en;q=0.8' \
--data-raw '{
    "type": "individualPan",
    "email": "[email protected]",
    "callbackUrl": "<https://www.w3schools.com",>
    "essentials": {}
}'

Input Parameters

Parameter Name	Required/Optional	Description
Authorization	Required	Contains the id parameter returned from the login step
Content-Type	Required	application/json
type	Required	Type of identity
email	Required	E-mail ID
callbackurl	Required	Endpoint where the response will be posted
essentials.images	Required	URL of the PAN image

Sample Response

{
    "type": "individualPan",
    "email": "..email..
    "callbackUrl": "<https://www.w3schools.com",>
    "images": [
        "<https://<Front> side image URL>"
        
    ],
    "accessToken": "..accessToken..",
    "autoRecognition": [],
    "verification": [],
    "forgeryCheck": [],
    "id": "..id..",
    "patronId": "..patronId.."
}

Response Parameter

Parameter Name	Description
accessToken	This is provided by identities API
autoRecognition	Auto recognizes text from upload image
verification	verification is done
forgeryCheck	Forgery check is done
id	Unique user id
patronId	Unique patron id

Sample cURL

Preproduction

Production

curl --location --request POST 'https://preproduction.signzy.tech/api/v2/snoops' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'Authorization: <token>' \
--data-raw '{
    "service": "Identity",
    "itemId": " ",
    "accessToken": " ",
    "task": "signatureExtraction",
    "essentials": {}
       
}'

curl --location --request POST 'https://signzy.tech/api/v2/snoops' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'Authorization: <token>' \
--data-raw '{
    "service": "Identity",
    "itemId": " ",
    "accessToken": " ",
    "task": "signatureExtraction",
    "essentials": {}
       
}'

Input Parameters

Parameter Name	Required/Optional	Description
Authorization	Required	Contains the id parameter returned from the login step
Content-Type	Required	application/json
service	Required	Type of Signzy service - “identity extraction”
itemId	Required	Contains the identity item id
accessToken	Required	This is provided by the identities API
task	Required	The value of task should besignatureExtraction
essentials	Optional	Not required in this case .

Sample API Response


  {
    "service": "Identity",
    "itemId": " ",
    "task": "signatureExtraction",
    "essentials": {},
    "accessToken": " ",
    "id": " ",
    "response": {
        "result": {
            "signature": "URL of the image containing the signature "
        }
    }
}

Output Parameters

Parameter Name	Description
service	Type of Signzy service - “signatureExtraction”
itemId	Contains the identity item id
task	The type of task performed - “Auto Recognition”
essentials	Contains the essential output data
accessToken	Contains the access token that was received from identity request
Id	Contains the unique Id of the snoop request
response	An object that contains the actual response
result.signature	Contains the URL of the extracted signature

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected].