E-Stamp Verification API

Endpoint Overview

POST /api/v1/estamp/verification

Description

The E-Stamp Verification API enables real-time verification of electronic stamp certificates issued by state governments in India. This endpoint specifically supports Uttar Pradesh e-stamp certificates and provides comprehensive details about stamp duty transactions, including purchaser information, property descriptions, parties involved, and financial details.

This API streamlines the verification process by eliminating manual document checks and providing instant access to authentic e-stamp certificate data directly from government records. It's essential for legal compliance, fraud prevention, and document authentication in property transactions, legal proceedings, and financial services.

Key Benefits

Instant Verification: Get real-time validation of e-stamp certificates within seconds

Comprehensive Data: Access complete transaction details including parties, property descriptions, and duty amounts

Fraud Prevention: Verify authenticity directly from government databases to prevent document forgery

Legal Compliance: Ensure regulatory compliance for property transactions and legal documentation

Use Cases

Real Estate

Financial Services

Legal & Compliance

Property Transaction Verification: Validate e-stamp certificates during property purchases to ensure stamp duty compliance

Due Diligence: Verify document authenticity as part of property due diligence processes

Legal Documentation: Authenticate conveyance deeds and property transfer documents

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for API authentication (JWT)
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
state	string	Yes	State code for the e-stamp certificate (e.g., "uttar_pradesh")
certificate_number	string	Yes	Unique e-stamp certificate number (e.g., "IN-UP29253039519629T")
estamp_duty_type	string	Yes	E-stamp duty type code (e.g., "UP-RG-7")
certificate_issue_date	string	Yes	Certificate issue date in YYYY-MM-DD format

Example Request

{
  "state": "uttar_pradesh",
  "certificate_number": "IN-UP29253039519629T",
  "estamp_duty_type": "UP-RG-7",
  "certificate_issue_date": "2021-02-01"
}

Process Response

Response Parameters

Parameter	Type	Description
data	object	Container for all e-stamp certificate details
data.client_id	string	Unique client identifier for the verification request
data.certificate_number	string	E-stamp certificate number that was verified
data.state	string	State where the e-stamp was issued
data.estamp_duty_type	string	Type of e-stamp duty
data.certificate_issue_date	string	Date when the certificate was issued
data.account_reference	string	Government account reference for the transaction
data.reference_id	string	Unique reference ID for the e-stamp transaction
data.purchased_by	string	Name of the person who purchased the e-stamp
data.description_of_document	string	Description of the document type and purpose
data.property_description	string	Detailed description of the property involved
data.consideration_price	string	Consideration amount for the transaction
data.first_party	string	Name of the first party in the transaction
data.second_party	string	Name of the second party in the transaction
data.stamp_duty_paid_by	string	Name of the person who paid the stamp duty
data.stamp_duty_account	string	Amount of stamp duty paid with written format
status_code	integer	HTTP status code (200 for success)
success	boolean	Indicates if the verification was successful
message	string/null	Additional message or error description
message_code	string	Status message code

Example Successful Response

{
  "data": {
    "client_id": "estamp_verification_rfSseKCpeHpzefHrgVlx",
    "certificate_number": "IN-UP29253039519629T",
    "state": "uttar_pradesh",
    "estamp_duty_type": "UP-RG-7",
    "certificate_issue_date": "2021-02-01",
    "account_reference": "NEWIMPACC (SV)/ up14262604/ JANSATH/ UP-MJF",
    "reference_id": "SUBIN-UPUP1426260450149193474138T",
    "purchased_by": "JEENAT WO SHAHAJAD",
    "description_of_document": "Article 23 Conveyance",
    "property_description": "PLOT SITUATED AT VILL VALIPURA MUJHERA PARGANA B.S TEHSIL JANSATH DIST MZN",
    "consideration_price": "",
    "first_party": "SHAFIQ SO KALU",
    "second_party": "JEENAT WO SHAHAJAD",
    "stamp_duty_paid_by": "JEENAT WO SHAHAJAD",
    "stamp_duty_account": "15,500\n (FifteenThousand Five Hundred only)"
  },
  "status_code": 200,
  "success": true,
  "message": null,
  "message_code": "success"
}

Possible Error Responses

Invalid Certificate

Authentication Error

{
  "data": null,
  "status_code": 404,
  "success": false,
  "message": "Certificate not found or invalid certificate details",
  "message_code": "certificate_not_found"
}

This error occurs when the provided certificate number, duty type, or issue date doesn't match any records in the government database.

Integration Best Practices

Security Recommendations

Secure Token Storage: Store JWT tokens securely and never expose them in client-side code

Token Rotation: Implement regular token refresh mechanisms to maintain security

HTTPS Only: Always use HTTPS for API calls to protect sensitive data in transit

Input Validation: Validate all input parameters before sending requests to prevent injection attacks

User Experience Guidelines

Loading States: Implement appropriate loading indicators while verification is in progress

Error Handling: Provide clear, user-friendly error messages for different failure scenarios

Caching Strategy: Consider caching successful verifications to reduce API calls for repeated requests

Rate Limiting: Implement client-side rate limiting to avoid hitting API limits

Code Samples

cURL

Python

Node.js

Related APIs

Document Verification Suite: Additional APIs for verifying PAN cards, Aadhaar cards, and other government-issued documents
Address Verification API: Verify and standardize addresses for property-related transactions
Identity Verification APIs: Comprehensive identity verification solutions for KYC compliance

Compliance and Legal Considerations

This API accesses government databases and should be used in compliance with data protection regulations. Ensure proper consent mechanisms are in place when collecting user data for verification. The API is designed for legitimate business purposes including fraud prevention, legal compliance, and document authentication. Users must comply with applicable state and federal laws regarding data privacy and document verification.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/estamp/verification' \ --header 'Content-Type: application/json' \ --data-raw '{ "state": "uttar_pradesh", "certificate_number": "IN-UP29253039519629T", "estamp_duty_type": "UP-RG-7", "certificate_issue_date": "2021-02-01" }'

{ "data": { "client_id": "estamp_verification_rfSseKCpeHpzefHrgVlx", "certificate_number": "IN-UP29253039519629T", "state": "uttar_pradesh", "estamp_duty_type": "UP-RG-7", "certificate_issue_date": "2021-02-01", "account_reference": "NEWIMPACC (SV)/ up14262604/ JANSATH/ UP-MJF", "reference_id": "SUBIN-UPUP1426260450149193474138T", "purchased_by": "JEENAT WO SHAHAJAD", "description_of_document": "Article 23 Conveyance", "property_description": "PLOT SITUATED AT VILL VALIPURA MUJHERA PARGANA B.S TEHSIL JANSATH DIST MZN", "consideration_price": "", "first_party": "SHAFIQ SO KALU", "second_party": "JEENAT WO SHAHAJAD", "stamp_duty_paid_by": "JEENAT WO SHAHAJAD", "stamp_duty_account": "15,500\n (FifteenThousand Five Hundred only)" }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

Estamp Verification

E-Stamp Verification API#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses