Bangladesh NID Verification API

Endpoint Overview

POST /api/v1/bangladesh/nid-verification

Description

The Bangladesh NID Verification API enables businesses to verify the authenticity of Bangladesh National Identity Cards (NID) by cross-referencing the NID number with the provided date of birth. This API provides instant verification status, helping organizations confirm the validity of identity documents during customer onboarding, employee verification, and compliance processes.

This endpoint serves as a critical tool for businesses operating in Bangladesh or serving Bangladeshi customers, ensuring that NID numbers are legitimate and correspond to the provided personal information. The API returns a boolean verification status along with the submitted details, enabling seamless integration into existing KYC (Know Your Customer) and identity verification workflows.

Key Benefits

Instant Verification: Get real-time verification status of Bangladesh NID numbers

Fraud Prevention: Reduce identity fraud by validating NID authenticity against official records

Compliance Support: Meet regulatory requirements for customer identity verification

Seamless Integration: Easy-to-use API that integrates smoothly with existing systems

Use Cases

Financial Services

E-commerce & Marketplaces

HR & Employment

KYC compliance during account opening processes

Customer identity verification for loan applications

Digital wallet registration and verification

Insurance policy enrollment verification

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

Request Body

Parameter	Type	Required	Description
id_number	string	Yes	The Bangladesh NID number to be verified
dob	string	Yes	Date of birth in YYYY-MM-DD format

Example Request

{
  "id_number": "7862824589999",
  "dob": "1984-06-03"
}

Process Response

Response Parameters

Parameter	Type	Description
data	object	Contains verification results and request details
data.client_id	string	Unique identifier for the verification request
data.id_number	string	The NID number that was verified
data.dob	string	The date of birth used for verification
data.is_verified	boolean	Verification status - true if NID is valid, false otherwise
status_code	integer	HTTP status code of the response
success	boolean	Indicates if the API call was successful
message	string	Human-readable message describing the result
message_code	string	Machine-readable code for the result status

Example Successful Response

{
  "data": {
    "client_id": "bangladesh_nid_verification_wxHmLPwTsdznmhqFpxhX",
    "id_number": "7862824589999",
    "dob": "1984-06-03",
    "is_verified": true
  },
  "status_code": 200,
  "success": true,
  "message": "Success",
  "message_code": "success"
}

Possible Error Responses

Invalid Authentication

Invalid Input

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"
}

Returned when the JWT Bearer token is missing, invalid, or expired.

Integration Best Practices

Security Recommendations

Store JWT tokens securely and refresh them before expiration

Use HTTPS endpoints only for all API communications

Implement proper error handling and logging for failed verification attempts

Never log or store sensitive personal information in plain text

User Experience Guidelines

Provide clear feedback to users about verification status

Implement appropriate loading states during verification process

Handle verification failures gracefully with helpful error messages

Consider caching verification results to avoid redundant API calls

Code Samples

cURL

Python

Node.js

Related APIs

Bangladesh Passport Verification: Verify Bangladesh passport details and authenticity

Bangladesh Voter ID Verification: Validate voter registration information

Bangladesh Birth Certificate Verification: Confirm birth certificate authenticity

Multi-Document Verification: Batch verification of multiple identity documents

Compliance and Legal Considerations

When using the Bangladesh NID Verification API, ensure compliance with Bangladesh's data protection laws and regulations. Obtain proper consent from individuals before verifying their identity documents. The API should only be used for legitimate business purposes such as customer onboarding, compliance verification, or fraud prevention. Store and process personal data in accordance with local privacy regulations and implement appropriate data retention policies.

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/bangladesh/nid-verification' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "7862824589999", "dob": "1984-06-03" }'

{ "data": { "client_id": "bangladesh_nid_verification_wxHmLPwTsdznmhqFpxhX", "id_number": "7862824589999", "dob": "1984-06-03", "is_verified": true }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

NID Verification

Bangladesh NID 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