ICWAI Membership Verification

1 endpoint · Core API

The API for verifying Membership Numbers of Cost Accountants issued by the Institute of Cost and Works Accountants of India (ICWAI) serves as a reliable tool for authenticating the credentials of Certified Cost Accountants (CWAs). It enables organizations to swiftly and accurately confirm the validity of CWA membership numbers, ensuring compliance with regulatory requirements and reducing the risk of fraudulent activities. By integrating this API into their systems, businesses can streamline the verification process, enhance trust in their operations, and make informed decisions when engaging with professionals accredited by the ICWAI.

This API verifies Membership Numbers of Cost Accountants issued by the Institute of Cost and Works Accountants of India, ensuring accurate authentication of CWA credentials.

POST

/api/v1/icwaim/verify

#

Get CWAI Membership verification details

docs.signcare.io/core/api/professional-bodies/icwai-membership-verification/#post-api-v1-icwaim-verify

Headers

  • X-API-KEY
    stringrequired
    Your secret API key for the environment you are calling (Stage and Live use different keys).
  • X-API-APP-ID
    stringrequired
    The App ID issued together with the key.
  • Content-Type
    stringrequired
    application/json

Body parameters

application/json
  • consent
    stringrequired
    Required. The end user's consent to this verification. Send `Y`.
    minLength 1default Y
  • consent_text
    stringrequired
    Required. The consent statement shown to the end user. Send the default text from the sample.
    minLength 1default I hear by declare my consent agreeme…
  • request_id
    stringoptional
    Optional. Your own id to correlate this call in your logs. A unique id is generated if you leave it out.
    nullable
  • membershipNo
    stringrequired
    Gets or sets the ICWAI membership number to verify.
    minLength 5maxLength 10default 14XXX
Sample request body
{ "consent": "Y", "consent_text": "I hear by declare my consent agreement for fetching my information via SignCare API", "membershipNo": "14XXX" }

Responses

200OK
  • success
    booleanoptional
    No description.
  • statusCode
    integer (int32)optional
    No description.
    default 200
  • message
    stringoptional
    No description.
    nullabledefault XXXXX
  • data
    objectoptional
    Response model containing ICWAI membership verification details.
    16 fields
    • fname
      stringoptional
      Gets or sets the first name of the member.
      nullabledefault Richard Correa
    • mname
      stringoptional
      Gets or sets the middle name of the member.
      nullable
    • srName
      stringoptional
      Gets or sets the surname of the member.
      nullabledefault Correa
    • dob
      stringoptional
      Gets or sets the date of birth of the member.
      nullable
    • gender
      stringoptional
      Gets or sets the gender of the member.
      nullable
    • memCategory
      stringoptional
      Gets or sets the membership category.
      nullable
    • memshipDt
      stringoptional
      Gets or sets the membership date.
      nullable
    • memRegion
      stringoptional
      Gets or sets the membership region.
      nullable
    • chapter
      stringoptional
      Gets or sets the chapter the member belongs to.
      nullable
    • retired
      stringoptional
      Gets or sets whether the member is retired.
      nullable
    • protFirmName
      stringoptional
      Gets or sets the name of the professional firm.
      nullable
    • firmEftDt
      stringoptional
      Gets or sets the firm effective date.
      nullable
    • crtEmployer
      stringoptional
      Gets or sets the current employer name.
      nullable
    • effectiveDt
      stringoptional
      Gets or sets the effective date of employment.
      nullable
    • validUpDt
      stringoptional
      Gets or sets the valid up-to date of the membership.
      nullable
    • cancellationDt
      stringoptional
      Gets or sets the cancellation date of the membership, if applicable.
      nullable
  • messages
    array<string>optional
    No description.
    nullable
  • request_id
    stringoptional
    No description.
    nullable
  • isBillable
    booleanoptional
    Whether this request was charged: true if it was, false if not. Errors always show false. Flows that finish later (ITR Fetch, SHCIL eStamp, DigiLocker, eSign) show false here, because the charge is made when the result is ready. eSign charges each signer when they complete signing. DigiLocker deducts the credit when the link is created and refunds it automatically if the link expires before the user completes it.
Example
{ "success": false, "statusCode": 200, "message": "XXXXX", "data": { "fname": "Richard Correa", "mname": "", "srName": "Correa", "dob": "", "gender": "", "memCategory": "", "memshipDt": "", "memRegion": "", "chapter": "", "retired": "", "protFirmName": "", "firmEftDt": "", "crtEmployer": "", "effectiveDt": "", "validUpDt": "", "cancellationDt": "" }, "messages": [ "string" ], "request_id": "string", "isBillable": false }
400Bad Request
  • data
    objectoptional
    No description.
  • messages
    array<string>optional
    No description.
    nullable
  • request_id
    stringoptional
    No description.
    nullable
  • success
    booleanoptional
    No description.
    default false
  • message
    stringoptional
    No description.
    nullabledefault XXXXX
  • isBillable
    booleanoptional
    No description.
  • statusCode
    integer (int32)optional
    No description.
    default 400
Example
{ "data": {}, "messages": [ "string" ], "request_id": "string", "success": false, "message": "XXXXX", "isBillable": false, "statusCode": 400 }
401Unauthorized
  • data
    objectoptional
    No description.
  • messages
    array<string>optional
    No description.
    nullable
  • request_id
    stringoptional
    No description.
    nullable
  • success
    booleanoptional
    No description.
    default false
  • message
    stringoptional
    No description.
    nullabledefault XXXXX
  • isBillable
    booleanoptional
    No description.
  • statusCode
    integer (int32)optional
    No description.
    default 401
Example
{ "data": {}, "messages": [ "string" ], "request_id": "string", "success": false, "message": "XXXXX", "isBillable": false, "statusCode": 401 }
500Internal Server Error
  • data
    objectoptional
    No description.
  • messages
    array<string>optional
    No description.
    nullable
  • request_id
    stringoptional
    No description.
    nullable
  • success
    booleanoptional
    No description.
    default false
  • message
    stringoptional
    No description.
    nullabledefault XXXXX
  • isBillable
    booleanoptional
    No description.
  • statusCode
    integer (int32)optional
    No description.
    default 500
Example
{ "data": {}, "messages": [ "string" ], "request_id": "string", "success": false, "message": "XXXXX", "isBillable": false, "statusCode": 500 }
Code samplescurl · Node.js · Python
Stage: uat-ext.signcare.io
curl -X POST 'https://uat-ext.signcare.io/api/v1/icwaim/verify' \ -H 'X-API-KEY: YOUR_API_KEY' \ -H 'X-API-APP-ID: YOUR_APP_ID' \ -H 'Content-Type: application/json' \ -d '{ "consent": "Y", "consent_text": "I hear by declare my consent agreement for fetching my information via SignCare API", "membershipNo": "14XXX" }'