Death Certificate OCR

Endpoint Overview

POST /api/v1/ocr/death-certificate

Description

The Death Certificate OCR API extracts and verifies information from death certificate documents. It uses optical character recognition (OCR) to extract key details from uploaded death certificates and verifies the extracted information against official records. The API also validates QR codes if present on the document, providing a comprehensive verification solution.

Key Benefits

Automated extraction of 20+ fields from death certificates with confidence scores

Verification of extracted data against official records

QR code detection and validation for enhanced document authenticity

Support for both image and PDF document formats

Use Cases

Insurance

Banking & Finance

Government Services

Process death benefit claims by automatically extracting and verifying certificate details

Reduce manual verification time and improve claim processing efficiency

Detect potentially fraudulent death certificate submissions

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	multipart/form-data

Request Body

Request Body Formats

1. For File Upload

Parameter	Type	Required	Description
file	Image	Yes	Upload Cheque Image
use_pdf	Boolean	No	Set to true if the file type is PDF

2. For Base64 Input

Parameter	Type	Required	Description
base_64	String	Yes	Cheque Image in Base64 format

3. For Image URL Input

Parameter	Type	Required	Description
link	String	Yes	Cheque Image Link/URL

Example Request

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains all the extracted and verified information
data.client_id	String	Unique identifier for the API request
data.ocr_response	Object	Contains all fields extracted from the document with confidence scores
data.verifier_response	Object	Contains verified data from official records
data.name_match	Boolean	Indicates if the deceased's name matches verified data
data.date_of_death_match	Boolean	Indicates if the date of death matches verified data
data.registration_number_match	Boolean	Indicates if the registration number matches verified data
data.name_of_father_match	Boolean	Indicates if the father's name matches verified data
data.application_number_match	Boolean	Indicates if the application number matches verified data
data.serial_number_match	Boolean	Indicates if the serial number matches verified data
data.qr_found	Boolean	Indicates if a QR code was found on the document
data.valid_qr	Boolean	Indicates if the QR code is valid
data.qr_status	String	Status of the QR code verification
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": "ocr_death_certificate_ttwhOehfWsdZhAuGgcrR",
        "ocr_response": {
            "name_of_deceased": {
                "value": "SUNITA NARANG",
                "confidence": 99
            },
            "date_of_death": {
                "value": "2023-12-17",
                "confidence": 98
            },
            "age_of_deceased": {
                "value": "",
                "confidence": null
            },
            "address_of_deceased": {
                "value": "80 A COOL ROAD JYOTI NAGAR GATE NO 9 JALANDHAR",
                "confidence": 98
            },
            "permanent_address_of_deceased": {
                "value": "80 A COOL ROAD JYOTI NAGAR GATE NO 9 JALANDHAR",
                "confidence": 99
            },
            "date_of_issue": {
                "value": "2023-12-26",
                "confidence": 98
            },
            "updated_on": {
                "value": "",
                "confidence": null
            },
            "place_of_death": {
                "value": "NHS HOSPITAL NASA BRAIN AND SPINE CENTRE JALANDHAR",
                "confidence": 99
            },
            "sex": {
                "value": "Female",
                "confidence": 99
            },
            "name_of_spouse": {
                "value": "KRISHAN CHANDER VERMA",
                "confidence": 98
            },
            "state_name": {
                "value": "Punjab",
                "confidence": 97
            },
            "city": {
                "value": "Jalandhar",
                "confidence": 99
            },
            "district": {
                "value": "Jalandhar",
                "confidence": 98
            },
            "pincode": {
                "value": "",
                "confidence": null
            },
            "certificate_number": {
                "value": "",
                "confidence": null
            },
            "authority": {
                "value": "Chief Registrar (Birth & Death), Punjab",
                "confidence": 98
            },
            "name_of_father": {
                "value": "WONG DAN DANMOL RATTAN NARANG",
                "confidence": 99
            },
            "date_of_registration": {
                "value": "2023-12-25",
                "confidence": 98
            },
            "serial_number": {
                "value": "ES18484053",
                "confidence": 98
            },
            "application_number": {
                "value": "",
                "confidence": null
            },
            "deceased_aadhaar_number": {
                "value": "",
                "confidence": null
            },
            "father_aadhaar_number": {
                "value": "",
                "confidence": null
            },
            "mother_aadhaar_number": {
                "value": "",
                "confidence": null
            },
            "registration_number": {
                "value": "DU/ES/23/0056380019",
                "confidence": 98
            }
        },
        "verifier_response": {
            "name_of_deceased": "SUNITA NARANG",
            "date_of_death": "2023-12-17",
            "registration_number": "DU/ES/23/0056123456",
            "name_of_father": "KRISHAN CHANDER VERMA R",
            "serial_number": "",
            "application_number": ""
        },
        "name_match": true,
        "date_of_death_match": true,
        "registration_number_match": true,
        "name_of_father_match": false,
        "application_number_match": false,
        "serial_number_match": false,
        "qr_found": true,
        "valid_qr": true,
        "qr_status": "verified"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Authentication Error

Invalid Image

Invalid File Format

Server Error

{
    "error": null,
    "message": "Your token is invalid. Please ensure that correct token is being used.",
    "status_code": 401,
    "success": false,
    "message_code": "invalid_token"
}

Occurs when the JWT token is missing, invalid, or expired.

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 rotation and expiration policies for enhanced security

User Experience Guidelines

Provide clear feedback to users when document upload is in progress

Implement retry logic for temporary API failures

Display confidence scores to users for fields with low confidence values

Allow users to manually correct fields with low confidence scores

Code Samples

cURL

Python

Node.js

Related APIs

Birth Certificate OCR API: Extract and verify information from birth certificates

Marriage Certificate OCR API: Extract and verify information from marriage certificates

Document Verification API: Verify the authenticity of various official documents

QR Code Verification API: Standalone API for verifying QR codes on official documents

Compliance and Legal Considerations

Death certificates contain sensitive personal information and must be handled in compliance with data protection regulations

Ensure proper consent is obtained before processing death certificate data

Implement appropriate data retention policies to avoid storing sensitive information longer than necessary

Be aware of regional variations in death certificate formats and verification processes

{ "data": { "client_id": "ocr_death_certificate_ttwhOehfWsdZhAuGgcrR", "ocr_response": { "name_of_deceased": { "value": "SUNITA NARANG", "confidence": 99 }, "date_of_death": { "value": "2023-12-17", "confidence": 98 }, "age_of_deceased": { "value": "", "confidence": null }, "address_of_deceased": { "value": "80 A COOL ROAD JYOTI NAGAR GATE NO 9 JALANDHAR", "confidence": 98 }, "permanent_address_of_deceased": { "value": "80 A COOL ROAD JYOTI NAGAR GATE NO 9 JALANDHAR", "confidence": 99 }, "date_of_issue": { "value": "2023-12-26", "confidence": 98 }, "updated_on": { "value": "", "confidence": null }, "place_of_death": { "value": "NHS HOSPITAL NASA BRAIN AND SPINE CENTRE JALANDHAR", "confidence": 99 }, "sex": { "value": "Female", "confidence": 99 }, "name_of_spouse": { "value": "KRISHAN CHANDER VERMA", "confidence": 98 }, "state_name": { "value": "Punjab", "confidence": 97 }, "city": { "value": "Jalandhar", "confidence": 99 }, "district": { "value": "Jalandhar", "confidence": 98 }, "pincode": { "value": "", "confidence": null }, "certificate_number": { "value": "", "confidence": null }, "authority": { "value": "Chief Registrar (Birth & Death), Punjab", "confidence": 98 }, "name_of_father": { "value": "WONG DAN DANMOL RATTAN NARANG", "confidence": 99 }, "date_of_registration": { "value": "2023-12-25", "confidence": 98 }, "serial_number": { "value": "ES18484053", "confidence": 98 }, "application_number": { "value": "", "confidence": null }, "deceased_aadhaar_number": { "value": "", "confidence": null }, "father_aadhaar_number": { "value": "", "confidence": null }, "mother_aadhaar_number": { "value": "", "confidence": null }, "registration_number": { "value": "DU/ES/23/0056380019", "confidence": 98 } }, "verifier_response": { "name_of_deceased": "SUNITA NARANG", "date_of_death": "2023-12-17", "registration_number": "DU/ES/23/0056123456", "name_of_father": "KRISHAN CHANDER VERMA R", "serial_number": "", "application_number": "" }, "name_match": true, "date_of_death_match": true, "registration_number_match": true, "name_of_father_match": false, "application_number_match": false, "serial_number_match": false, "qr_found": true, "valid_qr": true, "qr_status": "verified" }, "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 ********************

Death Certificate OCR

Death Certificate OCR#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Request Body Formats#

1. For File Upload#

2. For Base64 Input#

3. For Image URL Input#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

Death Certificate OCR

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Request Body Formats

1. For File Upload

2. For Base64 Input

3. For Image URL Input

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples