CIN Basic Verification

This API authenticates Company, LLP, FCRN, and Foreign LLP Identification Numbers issued by the Ministry of Corporate Affairs (MCA), ensuring secure validation of entity credentials.

cin_basic

POST https://secctrl.tutelar.io/api/v2/kyc/merchant/cin_basic

Header

Name

Value

Content-Type

application/json

Authorization

Bearer eyJhbGciOiJ.....

Post parameters description is given below,

Post Parameter

Type

Is Mandatory

Description

cin_number

String

Yes

Company CIN Number

consent

String

Yes

Consent is required to make the API request. Value Must Be "Y"

active_complaiance

String

Yes

If this is true, it will return active compliance details Value Must Be yes/no

Sample Post Parameters

{
    "cin_number": "U72900JK2019PTC010815",
    "consent": "Y",
    "active_compliance": "yes"
}

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "60e76d20-a398-4b6e-983f-49927c22d76c",
    "status": "completed",
    "result": {
        "cin_number": "U72900JK2019PTC010815",
        "company_Name": "ZEROTHWARE TECHNOLOGIES PRIVATE LIMITED",
        "roc_code": "ROC Jammu",
        "registration_number": "010815",
        "Company_Category": "Company limited by shares",
        "Company_SubCategory": "Non-government company",
        "Class_of_Company": "Private",
        "authorised_capital": "1000000",
        "paid_up_capital": "100000",
        "number_of_members": "",
        "Date_of_Incorporation": "31/01/2019",
        "alternative_address": null,
        "email_id": "Zerothware@gmail.com",
        "active_compliance": "",
        "suspended_at_stock_exchange": "",
        "date_of_last_agm": "30/09/2025",
        "date_of_balance_sheet": "31/03/2025",
        "company_status": "Active"
    },
    "requested_at": "2026-02-11T06:04:49.161Z",
    "completed_at": "2026-02-11T06:04:57.565Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "60e76d20-a398-4b6e-983f-49927c22d76c",
    "status": "in_progress",
    "requested_at": "2026-02-11T06:04:49.161Z"
}

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "CIN Number should not be empty",
        "field": "cin_number",
        "code": "BAD_REQUEST"
    }
},
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "consent should not be empty!",
        "field": "consent",
        "code": "BAD_REQUEST"
    }
},
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "consent must be 'Y'",
        "field": "consent",
        "code": "BAD_REQUEST"
    }
},
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Active Compliance  must be true/false",
        "field": "active_compliance",
        "code": "BAD_REQUEST"
    }
}

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "6f081576-1076-4a80-b626-c0411b56a49b",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2026-02-11T06:04:49.161Z",
    "completed_at": "2026-02-11T06:04:57.565Z"
}

Get details

GET https://secctrl.tutelar.io/api/v2/kyc/merchant/cin_basic

Query parameters description is given below,

Query Parameter

Type

Is Mandatory

Description

reference_id

String

Yes

Document reference id

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "60e76d20-a398-4b6e-983f-49927c22d76c",
    "status": "completed",
    "result": {
        "cin_number": "U72900JK2019PTC010815",
        "company_Name": "ZEROTHWARE TECHNOLOGIES PRIVATE LIMITED",
        "roc_code": "ROC Jammu",
        "registration_number": "010815",
        "Company_Category": "Company limited by shares",
        "Company_SubCategory": "Non-government company",
        "Class_of_Company": "Private",
        "authorised_capital": "1000000",
        "paid_up_capital": "100000",
        "number_of_members": "",
        "Date_of_Incorporation": "31/01/2019",
        "alternative_address": null,
        "email_id": "Zerothware@gmail.com",
        "active_compliance": "",
        "suspended_at_stock_exchange": "",
        "date_of_last_agm": "30/09/2025",
        "date_of_balance_sheet": "31/03/2025",
        "company_status": "Active"
    },
    "requested_at": "2026-02-11T06:04:49.161Z",
    "completed_at": "2026-02-11T06:04:57.565Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "60e76d20-a398-4b6e-983f-49927c22d76c",
    "status": "in_progress",
    "requested_at": "2026-02-11T06:04:49.161Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "6f081576-1076-4a80-b626-c0411b56a49b",
    "status": "failed",
    "error": {
        "message": "Invalid details were provided. Please submit valid details.",
        "code": "ERROR"
    },
    "requested_at": "2026-02-11T06:04:49.161Z",
    "completed_at": "2026-02-11T06:04:57.565Z"
}

PreviousCIN Verification NextVoter Id

Last updated 1 month ago