List Articles

Endpoint Overview

GET /api/v1/stamper-v2/list-articles

Description

This endpoint retrieves a comprehensive list of supported e-stamp articles available for a specific Indian state. It allows developers to access state-specific stamp article information, including article IDs, codes, and names, which can be used for e-stamping document processing and verification workflows.

Key Benefits

Access state-specific e-stamp article information through a single API call

Retrieve complete article details including IDs, codes, and descriptive names

Simplify e-stamping document workflows with accurate article classification

Enable dynamic form generation based on available stamp articles for each state

Use Cases

Legal Tech

Financial Services

Real Estate

Generate dynamic e-stamping forms with state-specific article options

Validate user-selected stamp articles against officially supported options

Build legal document automation systems with accurate stamp article selection

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 authentication (JWT format)
Content-Type	Yes	application/json

Query Parameters

Parameter	Type	Required	Description
state	String Enum	Yes	Two-letter state code representing an Indian state or union territory

Supported State Codes

Code	State/UT Name
AN	Andaman and Nicobar Islands
AP	Andhra Pradesh
AR	Arunachal Pradesh
AS	Assam
BR	Bihar
CH	Chandigarh
CT	Chhattisgarh
DL	Delhi
GA	Goa
GJ	Gujarat
HR	Haryana
HP	Himachal Pradesh
JH	Jharkhand
JK	Jammu and Kashmir
KA	Karnataka
KL	Kerala
MH	Maharashtra
ML	Meghalaya
MN	Manipur
MP	Madhya Pradesh
MZ	Mizoram
OR	Odisha
PB	Punjab
PY	Puducherry
RJ	Rajasthan
SK	Sikkim
TG	Telangana
TN	Tamil Nadu
TR	Tripura
UP	Uttar Pradesh
UT	Uttarakhand
WB	West Bengal

Example Request

GET /api/v1/stamper-v2/list-articles?state=MH

Process Response

Response Parameters

Parameter	Type	Description
data	Array	List of available stamp articles for the requested state
data[].article_id	Integer	Unique identifier for the stamp article
data[].article_code	String	Official code/number of the stamp article
data[].article_name	String	Descriptive name of the stamp article
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Human-readable status message
message_code	String	Machine-readable status code

Example Successful Response

{
    "data": [
        {
            "article_id": 22092,
            "article_code": "Article 20",
            "article_name": "Conveyance"
        },
        {
            "article_id": 22086,
            "article_code": "Article 30",
            "article_name": "Indeminity Bond"
        },
        {
            "article_id": 22088,
            "article_code": "Article 35(b)",
            "article_name": "without possession"
        },
        {
            "article_id": 22085,
            "article_code": "Article 4",
            "article_name": "Affidavit"
        },
        {
            "article_id": 22087,
            "article_code": "Article 42",
            "article_name": "Power of Attorney"
        },
        {
            "article_id": 22093,
            "article_code": "Article 49",
            "article_name": "Settlements"
        },
        {
            "article_id": 22270,
            "article_code": "Article 56(i)",
            "article_name": "Bank Guarantee - If related to paper bank guarantee"
        },
        {
            "article_id": 22271,
            "article_code": "Article 56(ii)",
            "article_name": "Bank Guarantee - If relating to e-bank guarantee"
        },
        {
            "article_id": 22090,
            "article_code": "Article 6(A)(iv)",
            "article_name": "Agreement"
        },
        {
            "article_id": 3969,
            "article_code": "Article 6(c)",
            "article_name": "Agreement In any other case"
        },
        {
            "article_id": 22362,
            "article_code": "Article 6(C)",
            "article_name": "Article 6(C) (old article)"
        },
        {
            "article_id": 22091,
            "article_code": "Article 7",
            "article_name": "Agreement"
        },
        {
            "article_id": 3970,
            "article_code": "Article 7(ii)",
            "article_name": "Relating to pawn or pledge or 0.5% (subject to a hypothecation of movables)"
        },
        {
            "article_id": 22351,
            "article_code": "article AP1",
            "article_name": "article AP1 (old article)"
        }
    ],
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid State Code

Authentication Error

{
    "data": null,
    "status_code": 400,
    "success": false,
    "message": "Invalid state code provided",
    "message_code": "invalid_state_code"
}

This error occurs when the state code provided is not one of the supported state codes.

Integration Best Practices

Security Recommendations

Store JWT tokens securely and never expose them in client-side code

Implement token refresh mechanisms to handle token expiration

Use HTTPS for all API communications to ensure data encryption

Implement proper error handling for authentication failures

User Experience Guidelines

Cache article lists for frequently used states to improve performance

Implement dropdown or searchable selection interfaces for article selection

Display both article code and name to users for better clarity

Sort articles alphabetically or by article code for easier navigation

Code Samples

cURL

Python

Node.js

Related APIs

E-Stamp Generation API: Create e-stamps using the articles retrieved from this endpoint

E-Stamp Verification API: Verify the authenticity of e-stamps

Document Upload API: Upload documents for e-stamping

State Duty Calculator API: Calculate stamp duty for specific articles

Compliance and Legal Considerations

The stamp articles returned by this API are based on official state stamp acts and regulations. Different states have different stamp duty structures and article classifications. Always ensure you are using the most up-to-date article information for legal compliance. The e-stamping process must adhere to the respective state's stamp act provisions.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

{ "data": [ { "article_id": 22092, "article_code": "Article 20", "article_name": "Conveyance" }, { "article_id": 22086, "article_code": "Article 30", "article_name": "Indeminity Bond" }, { "article_id": 22088, "article_code": "Article 35(b)", "article_name": "without possession" }, { "article_id": 22085, "article_code": "Article 4", "article_name": "Affidavit" }, { "article_id": 22087, "article_code": "Article 42", "article_name": "Power of Attorney" }, { "article_id": 22093, "article_code": "Article 49", "article_name": "Settlements" }, { "article_id": 22270, "article_code": "Article 56(i)", "article_name": "Bank Guarantee - If related to paper bank guarantee" }, { "article_id": 22271, "article_code": "Article 56(ii)", "article_name": "Bank Guarantee - If relating to e-bank guarantee" }, { "article_id": 22090, "article_code": "Article 6(A)(iv)", "article_name": "Agreement" }, { "article_id": 3969, "article_code": "Article 6(c)", "article_name": "Agreement In any other case" }, { "article_id": 22362, "article_code": "Article 6(C)", "article_name": "Article 6(C) (old article)" }, { "article_id": 22091, "article_code": "Article 7", "article_name": "Agreement" }, { "article_id": 3970, "article_code": "Article 7(ii)", "article_name": "Relating to pawn or pledge or 0.5% (subject to a hypothecation of movables)" }, { "article_id": 22351, "article_code": "article AP1", "article_name": "article AP1 (old article)" } ], "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

List Articles

List Articles#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Query Parameters#

Supported State Codes#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

List Articles

Description

Use Cases

Technical Implementation

Request Headers

Query Parameters

Supported State Codes

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples