WB Certificate

Endpoint Overview

POST /api/v1/wb-certificate/

Description

This endpoint allows you to retrieve detailed information from a West Bengal (WB) Certificate by providing the certificate number. The API validates the certificate and returns comprehensive details including the holder's personal information, caste details, and certificate issuance information. This verification is essential for identity verification processes, government service eligibility checks, and social welfare program enrollment.

Key Benefits

Instant verification of West Bengal certificates without manual document review

Access to comprehensive certificate holder details including caste information

Reliable data sourced directly from official government records

Streamlined KYC and eligibility verification for government programs

Use Cases

Financial Services

Government Services

Educational Institutions

Verify applicant eligibility for special loan programs based on caste certificates

Validate identity documents during account opening procedures

Confirm customer details for government-backed financial inclusion initiatives

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. Format: `Bearer YOUR_JWT_TOKEN`
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
certificate_number	String	Yes	The West Bengal certificate number to be verified (e.g., "WB0702OBC201916320")

Example Request

{
    "certificate_number": "WB0702OBC201916320"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the certificate verification details
data.client_id	String	Unique identifier for the verification request
data.certificate_number	String	The certificate number that was verified
data.issued_by	String or null	Authority that issued the certificate
data.date_of_issue	String	Date when the certificate was issued (YYYY-MM-DD format)
data.full_name	String	Full name of the certificate holder
data.address	String	Complete address of the certificate holder
data.father_name	String	Father's name of the certificate holder
data.gender	String	Gender of the certificate holder
data.caste	String	Caste details including category (e.g., OBC-A) and subcaste
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the API call was successful
message	String	Human-readable status message
message_code	String	Machine-readable status code

Example Successful Response

{
    "data": {
        "client_id": "wb_certificate_dyRAjARxXRsguHnsNYjl",
        "certificate_number": "WB0702OBC201916320",
        "issued_by": null,
        "date_of_issue": "2019-11-11",
        "full_name": "SAIMUDDIN SK",
        "address": "CHANDRAPARA, PO : PURAPARA, PS : SUTI, Murshidabad, WEST BENGAL",
        "father_name": "RABIUL",
        "gender": "Male",
        "caste": "OBC-A ( SHERSHABADIA )"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Certificate

Authentication Error

Server Error

{
    "status_code": 400,
    "success": false,
    "message": "Invalid certificate number",
    "message_code": "invalid_certificate"
}

The provided certificate number is not valid or does not exist in the system.

Integration Best Practices

Security Recommendations

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

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications to ensure data encryption in transit

Implement token refresh mechanisms to handle token expiration gracefully

User Experience Guidelines

Implement clear error messages for end-users when certificate validation fails

Add loading indicators during API calls to improve perceived performance

Cache successful verification results to reduce redundant API calls

Provide clear instructions for users to enter certificate numbers correctly

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Verify Permanent Account Number details for identity verification

Aadhaar Verification API: Verify Aadhaar card details for identity confirmation

Voter ID Verification API: Verify voter identity card information

Driving License Verification API: Verify driving license details

Compliance and Legal Considerations

The use of this API must comply with the Information Technology Act, 2000 and relevant data protection regulations in India. Ensure you have proper consent from users before verifying their certificate information. The data obtained should only be used for the specific purpose disclosed to the user and should not be stored longer than necessary for the intended purpose.

{ "data": { "client_id": "wb_certificate_dyRAjARxXRsguHnsNYjl", "certificate_number": "WB0702OBC201916320", "issued_by": null, "date_of_issue": "2019-11-11", "full_name": "SAIMUDDIN SK", "address": "CHANDRAPARA, PO : PURAPARA, PS : SUTI, Murshidabad, WEST BENGAL", "father_name": "RABIUL", "gender": "Male", "caste": "OBC-A ( SHERSHABADIA )" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

WB Certificate

WB Certificate#

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

WB Certificate

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples