Get Estamp List

Endpoint Overview

POST /api/v1/estamp/get-estamp-list

Description

The Get Estamp List API retrieves a comprehensive catalog of all available Estamp document types and their corresponding reference codes for a specific Indian state or union territory. This endpoint is essential for applications that need to process, validate, or generate Estamp documents, as it provides the complete mapping between document names and their official state-specific reference codes.

Each state in India maintains its own unique set of Estamp codes for different legal document types. This API eliminates the need to maintain separate databases of Estamp codes by providing real-time access to the most current and accurate Estamp classifications for any supported state. The response includes detailed document type names along with their standardized reference numbers and state-specific codes.

Key Benefits

State-Specific Data: Access accurate Estamp codes tailored to specific state regulations and requirements

Comprehensive Coverage: Complete catalog of all legal document types supported for Estamp processing

Real-Time Updates: Always current information reflecting the latest state-level Estamp classifications

Standardized Format: Consistent data structure enabling easy integration with existing document management systems

Use Cases

Legal & Compliance

Financial Services

Government & Public Sector

Document Preparation Systems: Generate legally compliant documents with correct Estamp codes

Legal Practice Management: Automate Estamp selection for different types of legal instruments

Compliance Auditing: Verify that documents use appropriate Estamp classifications

Court Filing Systems: Ensure proper Estamp documentation for legal proceedings

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 containing your JWT for API authentication
Content-Type	Yes	application/json - Required for POST request body

Request Body

Parameter	Type	Required	Description
state	String	Yes	The state identifier in snake_case format (e.g., "puducherry", "tamil_nadu"). Use the state identifiers from the Get State List API

Example Request

{
    "state": "puducherry"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Dictionary containing Estamp document types as keys and their corresponding state-specific codes as values
status_code	Integer	HTTP status code indicating the result (200 for success)
message_code	String	Internal status code for the operation ("success" for successful requests)
message	String	Human-readable status message describing the result
success	Boolean	Indicates whether the API call was successful (true/false)

Example Successful Response

{
    "data": {
        "Acknowledgement [1]": "PY-RG-26",
        "Administration-Bond [2]": "PY-RG-27",
        "Adoption-Deed [3]": "PY-RG-1",
        "Affidavit [4]": "PY-RG-28",
        "Agreement or Memorandum of Agreement [5]": "PY-RG-29",
        "Agreement relating to Deposit of Title Deeds, Pawn or Pledge [6]": "PY-RG-2",
        "Appointment in Execution of a Power [7]": "PY-RG-30",
        "Appraisement or Valuation [8]": "PY-RG-31",
        "Apprenticeship deed [9]": "PY-RG-32",
        "Articles of Association of a Company [10]": "PY-RG-33",
        "Articles of Clerkship [11]": "PY-RG-34",
        "Award [12]": "PY-RG-3",
        "Bill of Exchange [13]": "PY-RG-35",
        "Bill of Lading [14]": "PY-RG-36",
        "Bond [15]": "PY-RG-37",
        "Bottomry Bond [16]": "PY-RG-38",
        "Cancellation [17]": "PY-RG-39",
        "Certificate of Sale [18]": "PY-RG-4",
        "Certificate or Other Document [19]": "PY-RG-5",
        "Charter-Party [20]": "PY-RG-40",
        "Composition-Deed [22]": "PY-RG-6",
        "Conveyance [23]": "PY-RG-7",
        "Conveyance in the Nature of Part Performance [23(A)]": "PY-RG-41",
        "Copy or Extract [24]": "PY-RG-42",
        "Counterpart or Duplicate [25]": "PY-RG-43",
        "Customs Bond [26]": "PY-RG-44",
        "Debenture [27]": "PY-RG-8",
        "Delivery- Order in respect of Goods [28]": "PY-RG-45",
        "Dissolution of Pawn or Pledge [46(B)]": "PY-RG-17",
        "Divorce [29(i)]": "PY-RG-46",
        "Dower [29(ii)]": "PY-RG-47",
        "Duplicate [29(iii)]": "PY-RG-48",
        "Entry as an advocate Vakil or Attorney on the roll of any High Court [30]": "PY-RG-49",
        "Exchange of Property [31]": "PY-RG-9",
        "Further Charge [32]": "PY-RG-50",
        "Gift [33(i)]": "PY-RG-10",
        "Hiring Agreement [33(ii)]": "PY-RG-11",
        "Indemnity-Bond [34(i)]": "PY-RG-51",
        "Inspectorship-Deed [34(ii)]": "PY-RG-52",
        "Insurance [34(iii)]": "PY-RG-53",
        "Lease-more than one year [35]": "PY-RG-12",
        "Lease-not exceeding one year [35]": "PY-RG-54",
        "Letter of Alloment of Shares [36]": "PY-RG-55",
        "Letter of Credit [37(i)]": "PY-RG-56",
        "Letter of Guarantee [37(ii)]": "PY-RG-57",
        "Letter of Licence [38]": "PY-RG-58",
        "Memorandum of Association of a Company [39]": "PY-RG-59",
        "Mortgage Deed - when possession is not given or agreed to be given as aforesaid [40(b)]": "PY-RG-79",
        "Mortgage of a Crop [41]": "PY-RG-14",
        "Mortgage-Deed [40]": "PY-RG-13",
        "Notarial Act [42]": "PY-RG-60",
        "Note of Memorandum [43]": "PY-RG-61",
        "Note of Protest by the Master of a Ship [44(i)]": "PY-RG-62",
        "Order for the Payment of Money [44(ii)]": "PY-RG-63",
        "Partition [45]": "PY-RG-15",
        "Partnership [46(A)]": "PY-RG-16",
        "Policy of Insurance [47]": "PY-RG-64",
        "Power of Attorney [48]": "PY-RG-65",
        "Promissory Note [49]": "PY-RG-66",
        "Protest by the Master of a Ship [51]": "PY-RG-68",
        "Protest of Bill or Note [50]": "PY-RG-67",
        "Proxy [52]": "PY-RG-69",
        "Receipt [53]": "PY-RG-70",
        "Reconveyance of Mortgaged Property [54]": "PY-RG-71",
        "Release [55]": "PY-RG-18",
        "Respondentia Bond [56(i)]": "PY-RG-72",
        "Revocation of Any Trust or Settlement [56(ii)]": "PY-RG-73",
        "Security Bond or Mortgage Deed [57]": "PY-RG-74",
        "Settlement [58]": "PY-RG-19",
        "Share Warrants [59]": "PY-RG-75",
        "Shipping Order [60]": "PY-RG-76",
        "Surrender of Lease [61]": "PY-RG-77",
        "Transfer [62]": "PY-RG-20",
        "Transfer of Lease [63]": "PY-RG-21",
        "Trust: Declaration of [64(i)(A)]": "PY-RG-22",
        "Trust: Revocation of [64(i)(B)]": "PY-RG-23",
        "Vakil [64(iii)]": "PY-RG-25",
        "Valuation [64(ii)]": "PY-RG-24",
        "Warrant for Goods [65]": "PY-RG-78"
    },
    "status_code": 200,
    "message_code": "success",
    "message": "Success",
    "success": true
}

Possible Error Responses

Invalid State

Authentication Error

Missing Parameters

{
    "status_code": 400,
    "message_code": "invalid_state",
    "message": "Invalid state parameter. Please provide a valid state identifier.",
    "success": false,
    "data": null
}

This error occurs when the provided state parameter is not recognized or supported.

Integration Best Practices

Security Recommendations

Validate state parameters against the official state list before making API calls

Store JWT tokens securely and implement proper token refresh mechanisms

Use HTTPS only for all API communications to protect sensitive legal document information

Implement proper error handling to prevent exposure of internal system details

User Experience Guidelines

Cache Estamp lists by state to improve application performance and reduce API calls

Provide search and filter functionality for users to quickly find specific document types

Display both document names and reference codes for better user understanding

Implement graceful fallbacks when Estamp data is temporarily unavailable

Code Samples

cURL

Python

Node.js

Related APIs

Get State List API: Use this endpoint first to retrieve valid state identifiers for use with the Estamp List API

Estamp Verification API: Validate specific Estamp documents using the codes retrieved from this endpoint

Document Processing APIs: Additional services for handling legal document workflows and validations

Compliance and Legal Considerations

The Estamp codes returned by this API are specific to each state's legal framework and stamp duty regulations. Always ensure that you're using the correct state-specific codes for legal document processing. The document types and their classifications may vary between states due to different legal interpretations and local regulations. When processing legal documents, verify that the selected Estamp type matches the actual document content and purpose. This API provides reference data only and should not be considered as legal advice for document preparation or stamp duty calculations.

{ "data": { "Acknowledgement [1]": "PY-RG-26", "Administration-Bond [2]": "PY-RG-27", "Adoption-Deed [3]": "PY-RG-1", "Affidavit [4]": "PY-RG-28", "Agreement or Memorandum of Agreement [5]": "PY-RG-29", "Agreement relating to Deposit of Title Deeds, Pawn or Pledge [6]": "PY-RG-2", "Appointment in Execution of a Power [7]": "PY-RG-30", "Appraisement or Valuation [8]": "PY-RG-31", "Apprenticeship deed [9]": "PY-RG-32", "Articles of Association of a Company [10]": "PY-RG-33", "Articles of Clerkship [11]": "PY-RG-34", "Award [12]": "PY-RG-3", "Bill of Exchange [13]": "PY-RG-35", "Bill of Lading [14]": "PY-RG-36", "Bond [15]": "PY-RG-37", "Bottomry Bond [16]": "PY-RG-38", "Cancellation [17]": "PY-RG-39", "Certificate of Sale [18]": "PY-RG-4", "Certificate or Other Document [19]": "PY-RG-5", "Charter-Party [20]": "PY-RG-40", "Composition-Deed [22]": "PY-RG-6", "Conveyance [23]": "PY-RG-7", "Conveyance in the Nature of Part Performance [23(A)]": "PY-RG-41", "Copy or Extract [24]": "PY-RG-42", "Counterpart or Duplicate [25]": "PY-RG-43", "Customs Bond [26]": "PY-RG-44", "Debenture [27]": "PY-RG-8", "Delivery- Order in respect of Goods [28]": "PY-RG-45", "Dissolution of Pawn or Pledge [46(B)]": "PY-RG-17", "Divorce [29(i)]": "PY-RG-46", "Dower [29(ii)]": "PY-RG-47", "Duplicate [29(iii)]": "PY-RG-48", "Entry as an advocate Vakil or Attorney on the roll of any High Court [30]": "PY-RG-49", "Exchange of Property [31]": "PY-RG-9", "Further Charge [32]": "PY-RG-50", "Gift [33(i)]": "PY-RG-10", "Hiring Agreement [33(ii)]": "PY-RG-11", "Indemnity-Bond [34(i)]": "PY-RG-51", "Inspectorship-Deed [34(ii)]": "PY-RG-52", "Insurance [34(iii)]": "PY-RG-53", "Lease-more than one year [35]": "PY-RG-12", "Lease-not exceeding one year [35]": "PY-RG-54", "Letter of Alloment of Shares [36]": "PY-RG-55", "Letter of Credit [37(i)]": "PY-RG-56", "Letter of Guarantee [37(ii)]": "PY-RG-57", "Letter of Licence [38]": "PY-RG-58", "Memorandum of Association of a Company [39]": "PY-RG-59", "Mortgage Deed - when possession is not given or agreed to be given as aforesaid [40(b)]": "PY-RG-79", "Mortgage of a Crop [41]": "PY-RG-14", "Mortgage-Deed [40]": "PY-RG-13", "Notarial Act [42]": "PY-RG-60", "Note of Memorandum [43]": "PY-RG-61", "Note of Protest by the Master of a Ship [44(i)]": "PY-RG-62", "Order for the Payment of Money [44(ii)]": "PY-RG-63", "Partition [45]": "PY-RG-15", "Partnership [46(A)]": "PY-RG-16", "Policy of Insurance [47]": "PY-RG-64", "Power of Attorney [48]": "PY-RG-65", "Promissory Note [49]": "PY-RG-66", "Protest by the Master of a Ship [51]": "PY-RG-68", "Protest of Bill or Note [50]": "PY-RG-67", "Proxy [52]": "PY-RG-69", "Receipt [53]": "PY-RG-70", "Reconveyance of Mortgaged Property [54]": "PY-RG-71", "Release [55]": "PY-RG-18", "Respondentia Bond [56(i)]": "PY-RG-72", "Revocation of Any Trust or Settlement [56(ii)]": "PY-RG-73", "Security Bond or Mortgage Deed [57]": "PY-RG-74", "Settlement [58]": "PY-RG-19", "Share Warrants [59]": "PY-RG-75", "Shipping Order [60]": "PY-RG-76", "Surrender of Lease [61]": "PY-RG-77", "Transfer [62]": "PY-RG-20", "Transfer of Lease [63]": "PY-RG-21", "Trust: Declaration of [64(i)(A)]": "PY-RG-22", "Trust: Revocation of [64(i)(B)]": "PY-RG-23", "Vakil [64(iii)]": "PY-RG-25", "Valuation [64(ii)]": "PY-RG-24", "Warrant for Goods [65]": "PY-RG-78" }, "status_code": 200, "message_code": "success", "message": "Success", "success": true }

Get Estamp List

Get Estamp List#

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

Get Estamp List

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples