Disability Verification API

Endpoint Overview

POST /api/v1/disability/verification

Description

The Disability Verification API enables verification of disability certificates by validating UDID (Unique Disability Identification) numbers against the official government database. This API provides instant verification of disability status, helping organizations ensure compliance with accessibility requirements and validate disability-related claims or applications.

The API returns comprehensive information including the individual's masked personal details, hospital information where the disability was certified, and the current status of the UDID card. This verification process helps maintain the integrity of disability-related services and benefits while protecting sensitive personal information through data masking.

Key Benefits

Real-time Verification: Instant validation of UDID numbers against official government records

Comprehensive Data: Access to disability details, hospital information, and card status in a single API call

Privacy Protection: Sensitive information like UDID and Aadhaar numbers are masked to ensure data privacy

Compliance Support: Helps organizations meet legal requirements for disability verification and accessibility compliance

Use Cases

Financial Services

Government Services

Healthcare & Education

Verification of disability status for special loan schemes and financial assistance programs

Validation of disability certificates for insurance claim processing and premium calculations

KYC compliance for disability-specific banking products and services

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.app

Production: https://kyc-api.surepass.app

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for API authentication
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
disability_udid	String	Yes	The UDID (Unique Disability Identification) number to be verified

Example Request

{
  "disability_udid": "MH1923456789001122"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the verification response data
data.client_id	String	Unique identifier for the verification request
data.disability_id	String	The UDID number that was verified
data.details	Array	Array containing detailed information about the disability verification
data.details[].udid_number	String	Masked UDID number for privacy protection
data.details[].full_name	String	Full name of the disability certificate holder
data.details[].aadhaar_number	String	Masked Aadhaar number linked to the UDID
data.details[].hospital_name	String	Name of the hospital where disability was certified
data.details[].pwd_application_status	String	Current status of the UDID card
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates whether the API call was successful
message	String	Human-readable message describing the result
message_code	String	Machine-readable code for the response status

Example Successful Response

{
  "data": {
    "client_id": "disability_verification_abcd1234xyz",
    "disability_id": "MH1923456789001122",
    "details": [
      {
        "udid_number": "**************1122",
        "full_name": "Rahul Sharma",
        "aadhaar_number": "XXXXXXXX5678",
        "hospital_name": "Civil Hospital, Pune",
        "pwd_application_status": "UDID card is active"
      }
    ]
  },
  "status_code": 200,
  "success": true,
  "message": "Success",
  "message_code": "success"
}

Possible Error Responses

Invalid UDID

Authentication Error

{
    "status_code": 422,
    "success": false,
    "message": "Verification Failed.",
    "message_code": "verification_failed"
}

This error occur when the UDID is invalid or incorrect.

Integration Best Practices

Security Recommendations

Always use HTTPS endpoints and never transmit Bearer tokens over unsecured connections

Store JWT tokens securely and implement token refresh mechanisms for long-running applications

Implement proper error handling to avoid exposing sensitive information in error messages

Log API requests for audit purposes while ensuring no sensitive data is logged in plain text

User Experience Guidelines

Provide clear feedback to users when UDID verification is in progress

Display masked personal information appropriately to maintain privacy while confirming identity

Implement proper validation for UDID format before making API calls to reduce unnecessary requests

Handle verification failures gracefully with user-friendly error messages and retry options

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API - Verify Permanent Account Numbers for comprehensive identity verification
Aadhaar Verification API - Validate Aadhaar numbers to cross-verify identity information
Voter ID Verification API - Additional identity verification for government document validation
Driving License Verification API - Comprehensive identity and document verification services

Compliance and Legal Considerations

This API processes sensitive disability-related information and must be used in compliance with disability rights legislation and data protection regulations. Organizations using this API should ensure they have proper consent from individuals and legitimate business purposes for verification. The API implements data masking to protect privacy, but additional security measures should be implemented at the application level. Ensure compliance with local accessibility laws and regulations when using disability verification for decision-making processes.

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/disability/verification' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "disability_udid": "MH1923456789001122" }'

{ "data": { "client_id": "disability_verification_abcd1234xyz", "disability_id": "MH1923456789001122", "details": [ { "udid_number": "**************1122", "full_name": "Rahul Sharma", "aadhaar_number": "XXXXXXXX5678", "hospital_name": "Civil Hospital, Pune", "pwd_application_status": "UDID card is active" } ] }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Disability Verification

Disability Verification API#

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