Disability Verification V2

Endpoint Overview

POST /api/v1/disability/verification-v2

Description

The Disability Verification API v2 enables organizations to verify disability certificates and retrieve comprehensive information about individuals with disabilities. This endpoint validates disability credentials against government databases and provides detailed information including UDID (Unique Disability ID) numbers, certificate status, disability types, and personal details.

The API streamlines the verification process for disability benefits, employment opportunities, educational accommodations, and accessibility services by providing real-time access to authentic disability documentation and status information.

Key Benefits

Real-time Verification: Instant validation against official government disability databases

Comprehensive Data: Access to detailed disability information, application status, and certificate validity

Certificate Retrieval: Option to download official disability certificates in PDF format

Fraud Prevention: Secure verification process that prevents document forgery and identity fraud

Use Cases

Government Services

Corporate & HR

Education & Healthcare

Verification for disability benefit eligibility and disbursement

Authentication for government scheme applications and subsidies

Validation for accessibility infrastructure planning and resource allocation

Background verification for disability-specific government job reservations

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	JWT Bearer token for API authentication
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
id_number	String	Yes	UDID (Unique Disability ID) number of the individual
dob	String	Yes	Date of birth in YYYY-MM-DD format
get_certificate	Boolean	No	Flag to include certificate download link in response (default: false)

Example Request

{
    "id_number": "KA1234567890123456",
    "dob": "1980-01-01",
    "get_certificate": true
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for all response data
data.id_number	String	UDID number used in the request
data.dob	String	Date of birth used in the request
data.details	Object	Detailed disability information
data.details.application_number	String	Unique application reference number
data.details.udid_number	String	Verified UDID number
data.details.regional_language	String	Regional language code (e.g., 'kn' for Kannada)
data.details.full_name	String	Full name of the individual
data.details.father_name	String	Father's name
data.details.gender	String	Gender (M/F/O)
data.details.mobile	String	Registered mobile number
data.details.email	String/null	Registered email address
data.details.current_address	String	Current residential address
data.details.current_state_code	String	State code for current address
data.details.current_district_code	String	District code for current address
data.details.current_subdistrict_code	String	Sub-district code for current address
data.details.current_village_code	String	Village code for current address
data.details.current_pincode	String	PIN code for current address
data.details.disability_type_id	String	Numeric ID for disability type
data.details.application_status	String	Current application status code
data.details.pwd_card_expiry_date	String	PWD card expiry date
data.details.disability_type_pt	String	Disability type classification (P/T/M)
data.details.certificate_generate_date	String	Date when certificate was generated
data.details.aadhaar_number	String	Masked Aadhaar number
data.details.transfer_date	String	Transfer date (if applicable)
data.details.rejected_date	String	Rejection date (if applicable)
data.details.is_ekyc	String/null	eKYC status
data.details.pwd_application_status	Object	Application status details
data.details.pwd_application_status.status_name	String	Human-readable status description
data.details.pwd_dispatch	Object	Dispatch information
data.details.pwd_dispatch.dispatch_date	String	Date when card was dispatched
data.link	String	Direct download link for disability certificate (if requested)
status_code	Number	HTTP status code (200 for success)
success	Boolean	Request success indicator
message	String	Response message
message_code	String	Machine-readable message code

Example Successful Response

{
  "data": {
    "id_number": "KA1234567890123456",
    "dob": "1980-01-01",
    "details": {
      "application_number": "29120000020060000000",
      "udid_number": "KA1234567890123456",
      "regional_language": "kn",
      "full_name": "John Doe",
      "father_name": "Richard Roe",
      "gender": "M",
      "mobile": "9000000000",
      "email": null,
      "current_address": "S/O Richard Roe, Sample Village, Sample Post, Sample Taluk",
      "current_state_code": "29",
      "current_district_code": "500",
      "current_subdistrict_code": "5000",
      "current_village_code": "600000",
      "current_pincode": "560001",
      "disability_type_id": "3",
      "application_status": "11",
      "pwd_card_expiry_date": "1800-01-01",
      "disability_type_pt": "P",
      "certificate_generate_date": "2020-06-23",
      "aadhaar_number": "XXXXXXXX1234",
      "transfer_date": "1800-01-01",
      "rejected_date": "1800-01-01",
      "is_ekyc": null,
      "pwd_application_status": {
        "status_name": "UDID Card Dispatched."
      },
      "pwd_dispatch": {
        "dispatch_date": "2020-09-18"
      }
    },
    "link": "https://example.com/disability_certificate.pdf"
  },
  "status_code": 200,
  "success": true,
  "message": "Success",
  "message_code": "success"
}

Integration Best Practices

Security Recommendations

Store JWT tokens securely and implement automatic token refresh mechanisms

Always use HTTPS for API communications in production environments

Implement proper error handling to avoid exposing sensitive information

Log API requests and responses for audit trails while respecting privacy regulations

Validate and sanitize all input parameters before sending API requests

User Experience Guidelines

Provide clear feedback to users during the verification process with loading indicators

Implement retry mechanisms for failed requests with exponential backoff

Cache successful verification results temporarily to reduce API calls and improve response times

Display verification status clearly and provide actionable next steps for users

Handle certificate downloads gracefully with proper file naming and error handling

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Verify PAN card details and link with disability records

Aadhaar Verification API: Cross-verify Aadhaar details with disability database

Voter ID Verification API: Validate voter ID information for comprehensive identity verification

Driving License Verification API: Verify driving license status and disability endorsements

Compliance and Legal Considerations

This API processes sensitive personal and medical information. Ensure compliance with:

Data Protection Laws: Follow GDPR, Indian Personal Data Protection Bill, and local privacy regulations

Medical Privacy: Maintain confidentiality of disability information and use data only for legitimate purposes

Consent Management: Obtain proper user consent before accessing their disability records

Data Retention: Implement appropriate data retention policies and secure deletion procedures

Access Control: Restrict API access to authorized personnel only and maintain audit logs

PWD Act Compliance: Ensure usage aligns with Rights of Persons with Disabilities Act, 2016 guidelines

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-v2' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "KA1234567890123456", "dob": "1980-01-01", "get_certificate": true }'

{ "data": { "id_number": "KA1234567890123456", "dob": "1980-01-01", "details": { "application_number": "29120000020060000000", "udid_number": "KA1234567890123456", "regional_language": "kn", "full_name": "John Doe", "father_name": "Richard Roe", "gender": "M", "mobile": "9000000000", "email": null, "current_address": "S/O Richard Roe, Sample Village, Sample Post, Sample Taluk", "current_state_code": "29", "current_district_code": "500", "current_subdistrict_code": "5000", "current_village_code": "600000", "current_pincode": "560001", "disability_type_id": "3", "application_status": "11", "pwd_card_expiry_date": "1800-01-01", "disability_type_pt": "P", "certificate_generate_date": "2020-06-23", "aadhaar_number": "XXXXXXXX1234", "transfer_date": "1800-01-01", "rejected_date": "1800-01-01", "is_ekyc": null, "pwd_application_status": { "status_name": "UDID Card Dispatched." }, "pwd_dispatch": { "dispatch_date": "2020-09-18" } }, "link": "https://example.com/disability_certificate.pdf" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Integration Best Practices#

Code Samples#

Request

Responses