Darpan ID Verification API

Endpoint Overview

POST /api/v1/darpan/darpan-id-verification

Description

The Darpan ID Verification API enables organizations to instantly verify the authenticity and details of NGOs registered under the Darpan portal using their Darpan ID number. This API streamlines compliance, due diligence, and onboarding processes by providing real-time access to official NGO registration data, including organization name, type, registration details, address, sector focus, and geolocation.

This service is essential for businesses, financial institutions, and government agencies that need to validate NGO credentials for regulatory, partnership, or grant disbursement purposes. By automating the verification process, the API reduces manual effort, minimizes fraud risk, and ensures data accuracy.

Key Benefits

Real-time verification of NGO credentials using Darpan ID

Reduces manual compliance and onboarding workload

Minimizes risk of fraud and misrepresentation

Provides comprehensive NGO details, including sector and location

Use Cases

Banking & Financial Services

Government & Regulatory

Corporate Social Responsibility (CSR)

Automate NGO onboarding and KYC for grant disbursement or account opening

Validate NGO credentials before processing donations or financial transactions

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 in the format `Bearer TOKEN`
Content-Type	Yes	Must be `application/json`

Request Body

Parameter	Type	Required	Description
id_number	string	Yes	Darpan ID number to verify

Example Request

{
  "id_number": "DL/2025/0000000"
}

Process Response

Response Parameters

Certainly! Here’s the response parameter table, clearly showing the nesting using dot notation (e.g., data.client_id, data.details[0].ngo_name):

Parameter	Type	Description
data	object	Contains the verification result and NGO details
data.client_id	string	Unique client reference for this verification request
data.id_number	string	Darpan ID number that was verified
data.details	array	List of NGO details matching the provided Darpan ID
data.details[].ngo_name	string	Name of the NGO
data.details[].ngo_type	string	Type of NGO (e.g., Trust, Society)
data.details[].registration_number	string	NGO registration number
data.details[].district_name	string	District where the NGO is registered
data.details[].state_name	string	State where the NGO is registered
data.details[].address	string	Registered address of the NGO
data.details[].pin_code	string	Postal code of the NGO
data.details[].sub_district	string	Sub-district of the NGO
data.details[].last_update_on	string	Last update date of the NGO record (YYYY-MM-DD)
data.details[].sectors	string	Sectors in which the NGO operates
data.details[].migrated	boolean	Indicates if the NGO record is migrated
data.details[].latitude	string	Latitude coordinate of the NGO address
data.details[].longitude	string	Longitude coordinate of the NGO address
status_code	integer	HTTP status code (e.g., 200 for success)
success	boolean	Indicates if the request was successful
message	string	Additional message (null if successful)
message_code	string	Status message code (e.g., "success")

Example Successful Response

{
  "data": {
    "client_id": "darpan_id_verification_vhqfYQnjmrnjybnNlxNF",
    "id_number": "DL/2025/0000000",
    "details": [
      {
        "ngo_name": "SHRI GURU NANAK DEV WELFARE TRUST",
        "ngo_type": "Trust",
        "registration_number": "1234",
        "district_name": "CENTRAL",
        "state_name": "Punjab",
        "address": "H.NO 101, GURU NAGAR, AMRITSAR",
        "pin_code": "143001",
        "sub_district": "Amritsar-1",
        "last_update_on": "2025-06-15",
        "sectors": "Health, Education, Women Empowerment, Environment",
        "migrated": false,
        "latitude": "31.6340",
        "longitude": "74.8723"
      }
    ]
  },
  "status_code": 200,
  "success": true,
  "message": null,
  "message_code": "success"
}

Possible Error Responses

Invalid Token

Invalid Input

Server Error

{
  "status_code": 401,
  "success": false,
  "message": "Invalid or missing authentication token.",
  "message_code": "unauthorized"
}

Authentication failed due to missing or invalid JWT token.

Integration Best Practices

Security Recommendations

Always use HTTPS to protect sensitive data in transit.

Store API credentials and JWT tokens securely; never expose them in client-side code.

Rotate API keys and tokens periodically and immediately if compromised.

User Experience Guidelines

Validate user input before sending requests to avoid unnecessary API errors.

Display clear error messages to users when verification fails.

Cache successful verifications where appropriate to reduce redundant API calls.

Code Samples

cURL

Python

Node.js

Related APIs

NGO Registration Verification API: Verify NGO registration details using registration number.

PAN Verification API: Validate PAN numbers for individuals or organizations.

Aadhaar Verification API: Authenticate Aadhaar numbers for KYC processes.

Compliance and Legal Considerations

Ensure that all API usage complies with local data privacy laws and regulations. Use the API only for legitimate business purposes and do not store or share NGO data beyond what is necessary for your application. Obtain user consent where required.

This documentation is designed to help you implement the Darpan ID Verification API quickly and securely. For further support, contact Surepass technical support or refer to the official API documentation portal.

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/darpan/darpan-id-verification' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "DL/2025/0000000" }'

{ "data": { "client_id": "darpan_id_verification_vhqfYQnjmrnjybnNlxNF", "id_number": "DL/2025/0000000", "details": [ { "ngo_name": "SHRI GURU NANAK DEV WELFARE TRUST", "ngo_type": "Trust", "registration_number": "1234", "district_name": "CENTRAL", "state_name": "Punjab", "address": "H.NO 101, GURU NAGAR, AMRITSAR", "pin_code": "143001", "sub_district": "Amritsar-1", "last_update_on": "2025-06-15", "sectors": "Health, Education, Women Empowerment, Environment", "migrated": false, "latitude": "31.6340", "longitude": "74.8723" } ] }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

Darpan ID Verification

Darpan ID 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

Darpan ID 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