ICAI Membership Verification API

Endpoint Overview

POST /api/v1/corporate/icai

Description

The ICAI Membership Verification API allows you to validate and retrieve details of members registered with the Institute of Chartered Accountants of India (ICAI). This API provides a secure and efficient way to verify the membership status, certification details, and professional information of chartered accountants in India.

Key Benefits

Instant verification of ICAI membership status and credentials

Access to comprehensive professional details including certification status

Reduced risk of fraud through reliable identity verification

Streamlined compliance processes for financial and accounting services

Use Cases

Financial Services

Corporate Governance

Legal & Compliance

Verify credentials of chartered accountants before engaging their services

Validate professional qualifications during hiring processes

Confirm membership status for regulatory compliance requirements

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	Application/json

Request Body

Parameter	Type	Required	Description
membership_number	String	Yes	ICAI membership number of the chartered accountant to be verified

Example Request

{
    "membership_number": "012345"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the verification result data
data.client_id	String	Unique identifier for the verification request
data.membership_number	String	ICAI membership number that was verified
data.details	Object	Detailed information about the ICAI member
data.details.membership_no	String	ICAI membership number
data.details.member_status	String	Current status of the membership (Active/Inactive)
data.details.cop_status	String	Status of Certificate of Practice
data.details.associate_or_fellow	String	Level of ICAI membership
data.details.member_name	String	Full name of the ICAI member
data.details.gender	String	Gender of the member
data.details.professional_address	String	Professional address of the member
data.details.professional_region	String	Regional location of the member's practice
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the verification was successful
message	String	Additional information about the response (null if successful)
message_code	String	Code indicating the status of the response

Example Successful Response

{
    "data": {
        "client_id": "icai_HaAumcNfMtwcILLtmaEg",
        "membership_number": "012345",
        "details": {
            "membership_no": "012345",
            "member_status": "Active",
            "cop_status": "No COP",
            "associate_or_fellow": "",
            "member_name": "G.CHOPRA",
            "gender": "MALE",
            "professional_address": "KOLKATA - 700001, WEST BENGAL, INDIA",
            "professional_region": "EAST"
        }
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Invalid Membership Number

Authentication Error

{
    "data": null,
    "status_code": 400,
    "success": false,
    "message": "Invalid membership number provided",
    "message_code": "invalid_input"
}

This error occurs when the membership number format is incorrect or does not exist in ICAI records.

Integration Best Practices

Security Recommendations

Store API credentials securely and never expose them in client-side code

Implement proper error handling to avoid exposing sensitive information

Rotate JWT tokens periodically and don't reuse them across different environments

Implement request throttling to prevent abuse of the API

User Experience Guidelines

Provide clear feedback to users when verification is in progress

Display comprehensive member details in an organized, easy-to-read format

Implement proper error messaging when verification fails

Cache verification results (where appropriate) to improve response times

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Verify Permanent Account Number details

GST Verification API: Validate GST registration information

Company Verification API: Verify company registration details with MCA

Professional License Verification API: Verify credentials of various professionals

Compliance and Legal Considerations

This API provides access to professional information that may be subject to data protection regulations. Ensure you have appropriate consent before verifying an individual's professional credentials. The data should be used in compliance with ICAI guidelines and Indian data protection laws. Information retrieved should not be stored longer than necessary for the verification purpose.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/corporate/icai' \ --header 'Authorization: Bearer TOKEN' \ --header 'Content-Type: application/json' \ --data-raw '{ "membership_number": "01234" }'

{ "data": { "client_id": "icai_HaAumcNfMtwcILLtmaEg", "membership_number": "012345", "details": { "membership_no": "012345", "member_status": "Active", "cop_status": "No COP", "associate_or_fellow": "", "member_name": "G.CHOPRA", "gender": "MALE", "professional_address": "KOLKATA - 700001, WEST BENGAL, INDIA", "professional_region": "EAST" } }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

ICAI

ICAI Membership 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