Death Certificate Verification

Endpoint Overview

POST /api/v1/death/verification

Description

The Death Certificate Verification API allows you to verify death certificate details across multiple Indian states. This API validates the authenticity of death certificates by cross-referencing the provided parameters with official government records. It returns comprehensive information about the deceased person, including personal details, death registration information, and certificate status.

Key Benefits

Verify death certificates across 8 Indian states through a single API

Reduce fraud by validating official government death records

Streamline claims processing for insurance and financial institutions

Simplify estate settlement processes with verified death documentation

Use Cases

Insurance

Banking & Finance

Government Services

Verify death claims before processing insurance payouts

Automate death benefit verification for life insurance policies

Reduce fraudulent claims through official death certificate validation

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

Request Body

Parameter	Type	Required	Description
application_number	String	Depends on state	Application number of the death certificate
registration_number	String	Depends on state	Registration number of the death certificate
year	String	Depends on state	Year of death in YYYY format
date_of_death	String	Depends on state	Date of death in "YYYY-DD-MM" format
serial_number	String	Depends on state	Serial number of the death certificate
state_name	Enum	Yes	State name (must be one of the supported states)

State-specific Required Parameters

State	state_name	application_number	registration_number	year	date_of_death	serial_number
Delhi	✅	✅
Rajasthan	✅		✅
Gujarat	✅	✅		✅
Odisha	✅		✅		✅
West Bengal	✅	✅
Madhya Pradesh	✅		✅
Karnataka	✅	Refer to documentation	Refer to documentation	Refer to documentation	Refer to documentation	Refer to documentation
Punjab	✅					✅

Supported state_name Values

delhi

rajasthan

gujarat

odisha

west_bengal

madhya_pradesh

karnataka

punjab

Example Request

{
    "serial_number": "ES4001234",
    "state_name": "punjab"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains all the death certificate details
data.client_id	String	Unique client identifier for the verification request
data.registration_number	String	Registration number of the death certificate
data.application_number	String	Application number of the death certificate
data.date_of_death	String	Date of death in "YYYY-DD-MM" format
data.place_of_death	String	Location where the death occurred
data.name_of_deceased	String	Full name of the deceased person
data.father_name	String	Father's name of the deceased
data.mother_name	String	Mother's name of the deceased
data.address	String	Address of the deceased
data.gender	String	Gender of the deceased
data.name_of_applicant	String	Name of the person who applied for the death certificate
data.date_of_registration	String	Date when the death was registered in "YYYY-DD-MM" format
data.mobile_number	String	Mobile number of the applicant
data.year	String	Year of death
data.state_name	String	State where the death was registered
data.serial_number	String	Serial number of the death certificate
data.spouse_name	String	Name of the deceased's spouse
data.applicant_name	String	Name of the applicant
data.applicant_date	String	Date of application
data.permanent_address	String	Permanent address of the deceased
data.status	String	Status of the death certificate
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Response message
message_code	String	Code representing the response message

Example Successful Response

{
    "data": {
        "client_id": "death_verification_IvkwnNabpsfmrFkLVaMv",
        "registration_number": null,
        "application_number": "SJH0030000/2019",
        "date_of_death": null,
        "place_of_death": "SAFDARJUNG HOSPITAL NEW DELHI",
        "name_of_deceased": "VEER",
        "father_name": "NOT STATED",
        "mother_name": "RAJWATI",
        "address": null,
        "gender": null,
        "name_of_applicant": null,
        "date_of_registration": null,
        "mobile_number": null,
        "year": null,
        "state_name": "delhi",
        "serial_number": null,
        "spouse_name": null,
        "applicant_name": null,
        "applicant_date": null,
        "permanent_address": "BASANTPUR FARIDABAD HARYANA",
        "status": null
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Parameters

Authentication Error

Record Not Found

{
    "status_code": 400,
    "success": false,
    "message": "Missing required parameters for the selected state",
    "message_code": "invalid_parameters"
}

This error occurs when the required parameters for the selected state are not provided.

Integration Best Practices

Security Recommendations

Store API keys securely and never expose them in client-side code

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications

Implement IP whitelisting for production environments

Rotate JWT tokens periodically and implement token expiration

User Experience Guidelines

Provide clear error messages to end-users when verification fails

Implement retry logic with exponential backoff for temporary failures

Cache successful verification results to improve performance

Display a loading indicator during API calls to improve user experience

Validate input parameters before making API calls to reduce errors

Code Samples

cURL

Python

Node.js

Related APIs

Birth Certificate Verification API: Verify birth certificate details across multiple Indian states

Marriage Certificate Verification API: Verify marriage certificate details across multiple Indian states

Document OCR API: Extract information from uploaded death certificate documents

PAN Verification API: Verify PAN card details for identity verification

Compliance and Legal Considerations

This API accesses official government death records and is subject to data privacy regulations. Ensure you have proper consent and legal basis for accessing this information. Usage of this API must comply with the Information Technology Act, 2000 and other applicable Indian laws regarding personal data. Death certificate information should be handled with appropriate security measures and used only for legitimate business purposes.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/death/verification' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "serial_number": "ES4001234", "state_name": "punjab" }'

{ "data": { "client_id": "death_verification_IvkwnNabpsfmrFkLVaMv", "registration_number": null, "application_number": "SJH0030000/2019", "date_of_death": null, "place_of_death": "SAFDARJUNG HOSPITAL NEW DELHI", "name_of_deceased": "VEER", "father_name": "NOT STATED", "mother_name": "RAJWATI", "address": null, "gender": null, "name_of_applicant": null, "date_of_registration": null, "mobile_number": null, "year": null, "state_name": "delhi", "serial_number": null, "spouse_name": null, "applicant_name": null, "applicant_date": null, "permanent_address": "BASANTPUR FARIDABAD HARYANA", "status": null }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Death Certificate Verification

Death Certificate Verification#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

State-specific Required Parameters#

Supported state_name Values#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

Death Certificate Verification

Description

Use Cases

Technical Implementation

Request Headers

Request Body

State-specific Required Parameters

Supported state_name Values

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples