EZYTM...

GST STATUS CHECK API

POST

Gst status check api help in check the user gst status that he is a regular payer or not. It determines the legitimacy of the customer and prevents fraud.

Name: GST Status API


Type: POST


Request: https://planapi.in/Api/Ekyc/GSTReturnStatus

Parameter Type Position # Description
TokenID string Header Required Enter Genrated TokenId Credentials
ApiUserID string Header Required Enter given USERID Credentials
ApiPassword string Header Required Enter given PASSWORD Credentials
GstNumber string Body Required Enter 15 Digit GstNumber Number
ApiMode string Body Optional 0 for Test API/1 for Prodution

Response : 200

    {
        "Errorcode": 200,
        "status": "Success",
        "response": {
            "GstNumber": null,
            "FinancialYear": null,
            "Data": []
        }
    }

Response : 404

    {
        "Errorcode": 404,
        "status": "Failed",
        "response": {
            "GstNumber": null,
            "FinancialYear": null,
            "Data": []
        }
    }

GST ADVANCE API

POST

The GST Verification API allows users to verify and retrieve information related to Goods and Services Tax (GST) registrations for businesses. It provides detailed insights into the GSTIN, business details, jurisdictional information, registration status, and more.

Name: GST Advance API


Type: POST


Request: https://planapi.in/Api/Ekyc/GstDetailsAndVerify

Parameter Type Position # Description
TokenID string Header Required Enter Genrated TokenId Credentials
ApiUserID string Header Required Enter given USERID Credentials
ApiPassword string Header Required Enter given PASSWORD Credentials
GstNumber string Body Required Enter Gst Number
ApiMode string Body Optional 0 for Test API/1 for Prodution

Response : 100

    {
        "data": {
            "contact_details": {
                "principal": {
                    "address": "xxxx  Dummmy",
                    "email": "Dummy@gmail.com",
                    "mobile": "1231231234",
                    "nature_of_business": "Services"
                },
                "additional": []
            },
            "promoters": [
                " Dummy "
            ],
            "annual_turnover": "Slab: Rs. 1 Cr. to 5 Cr.",
            "annual_turnover_fy": "2023-2024",
            "percentage_in_cash_fy": "",
            "percentage_in_cash": "NA",
            "aadhaar_validation": "Yes",
            "aadhaar_validation_date": "2024-03-29T00:00:00",
            "address_details": {},
            "liability_percentage_details": {},
            "less_info": false,
            "einvoice_status": true,
            "client_id": "corporate_gstin_advancled_QlasfGMvomvjjgQSjktL",
            "gstin": "12XXXXXXXXXXXX",
            "pan_number": "XXXXXXXXX",
            "business_name": "Business Name",
            "legal_name": "Dummy ",
            "center_jurisdiction": "Test Test Jaipur, Rajasthan",
            "state_jurisdiction": "",
            "date_of_registration": "2017-01-23T00:00:00",
            "constitution_of_business": "",
            "taxpayer_type": "Regular",
            "gstin_status": "Active",
            "date_of_cancellation": "1800-01-01T00:00:00",
            "field_visit_conducted": "No",
            "nature_bus_activities": [
                "Supplier of Services"
            ],
            "nature_of_core_business_activity_code": "",
            "nature_of_core_business_activity_description": "",
            "filing_status": [],
            "address": null,
            "hsn_info": {},
            "filing_frequency": []
        },
        "Errorcode": 100,
        "status": "Success",
        "msg": "done"
    }

Response : 211

    {
        "data": {
            "contact_details": {
                "principal": {
                    "address": null,
                    "email": null,
                    "mobile": null,
                    "nature_of_business": null
                },
                "additional": null
            },
            "promoters": null,
            "annual_turnover": null,
            "annual_turnover_fy": null,
            "percentage_in_cash_fy": null,
            "percentage_in_cash": null,
            "aadhaar_validation": null,
            "aadhaar_validation_date": "0001-01-01T00:00:00",
            "address_details": null,
            "liability_percentage_details": null,
            "less_info": false,
            "einvoice_status": false,
            "client_id": null,
            "gstin": null,
            "pan_number": null,
            "business_name": null,
            "legal_name": null,
            "center_jurisdiction": null,
            "state_jurisdiction": null,
            "date_of_registration": "0001-01-01T00:00:00",
            "constitution_of_business": null,
            "taxpayer_type": null,
            "gstin_status": null,
            "date_of_cancellation": "0001-01-01T00:00:00",
            "field_visit_conducted": null,
            "nature_bus_activities": null,
            "nature_of_core_business_activity_code": null,
            "nature_of_core_business_activity_description": null,
            "filing_status": null,
            "address": null,
            "hsn_info": null,
            "filing_frequency": null
        },
        "Errorcode": 211,
        "status": "failed",
        "msg": "Invalid GSTIN"
    }

GST VERIFICATION API

POST

The GST Verification API helps businesses verify and validate the GST credentials of a registered taxpayer. It ensures the authenticity of the business, confirming its registration status, legal name, and nature of operations to prevent fraud and ensure compliance.

Name: GST Verification API


Type: POST


Request: https://planapi.in/Api/Ekyc/GSTVerification

Parameter Type Position # Description
TokenID string Header Required Enter Genrated TokenId Credentials
ApiUserID string Header Required Enter given USERID Credentials
ApiPassword string Header Required Enter given PASSWORD Credentials
GstNumber string Body Required Enter 15 Digit GstNumber Number
ApiMode string Body Optional 0 for Test API/1 for Prodution

Response : 200

                                {
      "Errorcode": 200,
      "status": "Success",
      "response": {
          "gstin": "27AAXXXXXXXXXXX",
          "legal_name": "XYZ INDIA PRIVATE LIMITED",
          "trade_name": "XYZ INDIA PRIVATE LIMITED",
          "taxpayer_type": "Regular",
          "reg_date": "2017-07-01",
          "state_code": "MHCGXXXX",
          "nature": "Supplier of Services",
          "address": {
              "addr1": "210",
              "addr2": "XXX XXXX",
              "pin": "XXXXXX",
              "state": "XXXXXXXXXX",
              "city": "XXXXXXXXX",
              "district": "XXXXXXXX"
          },
          "jurisdiction": "RANGE-IV",
          "business_type": "Private Limited",
          "last_update": "2021-01-28",
          "status": "Active"
    }

Response : 404

    {
      "Errorcode": 404,
      "status": "failed",
      "responce": {
          "gstin": null,
          "legal_name": null,
          "trade_name": null",
          "taxpayer_type": null,
          "reg_date": null,
          "state_code": null,
          "nature": null,
          "address": {           
          },
          "jurisdiction": null,
          "business_type": null,
          "last_update": null,
          "status": null
      }
    }

Tan Advance API

POST

The TAN Advanced API provides detailed information on a TAN holder in India, including name, address, contact details, and allotment date — ideal for verification and compliance purposes.

Name: TAN Advance Details


Type: POST


Request: https://planapi.in/Api/Ekyc/TanAdvance

Parameter Type Position # Description
TokenID string Header Required Enter Genrated TokenId Credentials
ApiUserID string Header Required Enter given USERID Credentials
ApiPassword string Header Required Enter given PASSWORD Credentials
TanNumber string Body Required Enter Your Tan Number
ApiMode string Body Required Enter Your ApiMode

Response : 200

{
    "Errorcode": 100,
    "Message": "done",
    "Status": "Success",
    "data": {
        "tan": "ABKT12345E",
        "details": {
            "full_name": "SOLUTIONS PRIVATE LIMITED",
            "first_name": "",
            "middle_name": "",
            "last_name": "",
            "tan_allotment_date": "2050-12-18",
            "address": {
                "line_1": "H.NO 123 ,SHIV COLONY",
                "line_2": ",",
                "line_3": "",
                "line_4": "",
                "line_5": "PANCHKULA",
                "state_code": 99,
                "zip": "123456",
                "full": "H.NO.123 SHIV COLONY , PANCHKULA 123456"
            },
            "email_1": "ABCD@LIVE.IN",
            "email_2": "",
            "phone_number": "1234567890"
        }
    }
}

Response : 404

{
    "Errorcode": 104,
    "Message": "Please check with all required parameters",
    "Status": "Failed",
    "data": {
        "tan": null,
        "details": null
    }
}

Tan Verification API

POST

The TAN Verification API verifies a Tax Deduction and Collection Account Number (TAN) in India and retrieves the holder’s name and other essential details from official records.

Name: TAN Verification Details


Type: POST


Request: https://planapi.in/Api/Ekyc/TanVerify

Parameter Type Position # Description
TokenID string Header Required Enter Genrated TokenId Credentials
ApiUserID string Header Required Enter given USERID Credentials
ApiPassword string Header Required Enter given PASSWORD Credentials
TanNumber string Body Required Enter Your Tan Number
ApiMode string Body Required Enter Your ApiMode

Response : 200

{
    "Errorcode": 100,
    "Message": "done",
    "Status": "Success",
    "data": {
        "tan": "RTKT06731E",
        "name": "TAXREX SOLUTIONS PRIVATE LIMITED"
    }
}

Response : 404

{
    "Errorcode": 104,
    "Message": "Please check with all required parameters",
    "Status": "Failed",
    "data": {
        "tan": null,
        "name": null
    }
}

TAN COMPANY SEARCH API

POST

The TAN Company Search API lets you find companies by name and state, providing their official TAN details from government records for verification and compliance purposes.

Name: TAN Company Search


Type: POST


Request: https://planapi.in/Api/Ekyc/TanCompanySearch

Parameter Type Position # Description
TokenID string Header Required Enter Genrated TokenId Credentials
ApiUserID string Header Required Enter given USERID Credentials
ApiPassword string Header Required Enter given PASSWORD Credentials
TanNumber string Body Required Enter Your Tan Number
ApiMode string Body Required Enter Your ApiMode

Response : 200

{
    "Errorcode": 100,
    "Message": "done",
    "Status": "Success",
    "data": {
        "search_company_name": "ABC PRIVATE LIMITED",
        "search_size": 10,
        "search_state": "DELHI",
        "exact_match": true,
        "hits": 1,
        "search_data": [
            {
                "tan": "DELS71234E",
                "company_name": "ABC PRIVATE LIMITED"
            }
        ]
    }
}

Response : 404

{
    "Errorcode": 104,
    "Message": "Please check with all required parameters",
    "Status": "Failed",
    "data": {
        "search_company_name": null,
        "search_size": 0,
        "search_state": null,
        "exact_match": false,
        "hits": 0,
        "search_data": null
    }
}

MCA CIN Search API

POST

The MCA CIN Search API takes in the Corporate Identification Number (CIN) to identify and retrieve information about the searched company.

Name: MCA CIN Search API


Type: POST


Request: https://planapi.in/Api/Ekyc/MCACinSearch

Parameter Type Position # Description
TokenID string Header Required Enter Genrated TokenId Credentials
ApiUserID string Header Required Enter given USERID Credentials
ApiPassword string Header Required Enter given PASSWORD Credentials
CIN string Body Required Enter CIN
ApiMode string Body Optional 0 for Test API/1 for Prodution

Response : 100

                                {
        "Errorcode": 100,
        "status": "Success",
        "msg": "done",
        "response": {
            "cin": null,
            "company_name": null,
            "roc_code": null,
            "registration_no": null,
            "company_category": null,
            "company_subcategory": null,
            "Aclass": null,
            "authorized_capital": null,
            "paidup_capital": null,
            "incorporation_date": null,
            "registered_address": null,
            "email_address": null,
            "listing_status": null,
            "last_agm_date": null,
            "last_balance_sheet_date": null,
            "company_status": null,
            "charges": null,
            "Directors": []
        }
    }

Response : 104

    {
        "Errorcode": 104,
        "status": "Failed",
        "msg": "Invalid CIN",
        "response": {
            "cin": null,
            "company_name": null,
            "roc_code": null,
            "registration_no": null,
            "company_category": null,
            "company_subcategory": null,
            "Aclass": null,
            "authorized_capital": null,
            "paidup_capital": null,
            "incorporation_date": null,
            "registered_address": null,
            "email_address": null,
            "listing_status": null,
            "last_agm_date": null,
            "last_balance_sheet_date": null,
            "company_status": null,
            "charges": null,
            "Directors": []
        }
    }

Tin Verification API

POST

The TIN Verification API verifies the authenticity of a Taxpayer Identification Number (TIN) in India and retrieves key taxpayer details such as registration status, dealer information, and validity.

Name: TIN Verification Details


Type: POST


Request: https://planapi.in/Api/Ekyc/TinVerification

Parameter Type Position # Description
TokenID string Header Required Enter Genrated TokenId Credentials
ApiUserID string Header Required Enter given USERID Credentials
ApiPassword string Header Required Enter given PASSWORD Credentials
TinNumber string Body Required Enter Your Tin Number
ApiMode string Body Required Enter Your ApiMode

Response : 200

{
    "Errorcode": 100,
    "Message": "done",
    "Status": "Success",
    "data": {
        "tin_number": "12345678915",
        "cst_number": "12345678915",
        "dealer_name": "RAM PERFURMERWORKS",
        "dealer_address": "PLOT NO-XX-21",
        "state_name": "Odisha",
        "pan_number": "NOT AVAILABLE",
        "registration_date": "1992-12-16",
        "valid_upto": "2013-07-20",
        "registration_status": "Cancelled"
    }
}

Response : 404

{
    "Errorcode": 104,
    "Message": "Please check with all required parameters",
    "Status": "Failed",
    "data": {
        "tin_number": null,
        "cst_number": null,
        "dealer_name": null,
        "dealer_address": null,
        "state_name": null,
        "pan_number": null,
        "registration_date": null,
        "valid_upto": null,
        "registration_status": null
    }
}

DIN Verification API

POST

This API provides detailed information about a Director Identification Number (DIN). It includes data related to the DIN holder's information, such as DIN number, father's name, DIN holder's full name, Mobile Number , PAN number, date of birth (DOB), email, etc.

Name: DIN Verification API


Type: POST


Request: https://planapi.in/Api/Ekyc/DINDetails

Parameter Type Position # Description
TokenID string Header Required Enter Genrated TokenId Credentials
ApiUserID string Header Required Enter given USERID Credentials
ApiPassword string Header Required Enter given PASSWORD Credentials
DIN string Body Required Enter DIN
ApiMode string Body Optional 0 for Test API/1 for Prodution

Response : 100

                                {
        "Errorcode": 100,
        "status": "Success",
        "msg": "done",
        "data": {
            "client_id": "corporate_din_dewLYdlXsaxuPvoyogck",
            "din_number": "123112",
            "father_name": "Dummy",
            "full_name": "Dummy data",
            "dob": "1994-07-14T00:00:00",
            "nationality": "IN",
            "present_address": "Address",
            "permanent_address": "",
            "email": "sda@gmail.com",
            "pan_number": null,
            "companies_associated": [],
            "status": "success"
        }
    }

Response : 211

    {
        "Errorcode": 211,
        "status": "Failed",
        "msg": "Verification Failed.",
        "data": {
            "client_id": null,
            "din_number": null,
            "father_name": null,
            "full_name": null,
            "dob": "0001-01-01T00:00:00",
            "nationality": null,
            "present_address": null,
            "permanent_address": null,
            "email": null,
            "pan_number": null,
            "companies_associated": null,
            "status": null
        }
    }

NAME TO CIN LIST API

POST

This API lets you search for companies by name and retrieve details such as CIN, registered name, and company type—ideal for verifying company existence and streamlining corporate KYC.

Name: NAME TO CIN LIST


Type: POST


Request: https://planapi.in/Api/Ekyc/NameToCinList

Parameter Type Position # Description
TokenID string Header Required Enter Genrated TokenId Credentials
ApiUserID string Header Required Enter given USERID Credentials
ApiPassword string Header Required Enter given PASSWORD Credentials
Company_Name string Body Required Enter Your Company Name
ApiMode string Body Required Enter Your ApiMode

Response : 200

{
    "Errorcode": 100,
    "Message": "done",
    "Status": "Success",
    "data": {
        "company_name_search": "ezytm",
        "company_list": [
            {
                "cin_number": "U749991XXXXXXTC061530",
                "company_name": "EZYTM TECHNOLOGIES PRIVATE LIMITED",
                "company_type": "pvt_ltd"
            }
        ]
    }
}

Response : 404

{
    "Errorcode": 104,
    "Message": "Please check with all required parameters",
    "Status": "Failed",
    "data": {
        "company_name_search": null,
        "company_list": null
    }
}

MCA Company Search API

POST

This API provides the user with all information related to any company based on the Company Name.

Name: MCA Company API


Type: POST


Request: https://planapi.in/Api/Ekyc/MCACompanySearch

Parameter Type Position # Description
TokenID string Header Required Enter Genrated TokenId Credentials
ApiUserID string Header Required Enter given USERID Credentials
ApiPassword string Header Required Enter given PASSWORD Credentials
Company_Name string Body Required Enter Company_Name Test Company
ApiMode string Body Optional 0 for Test API/1 for Prodution

Response : 100

                                {
        "Errorcode": 100,
        "status": "Success",
        "msg": "done",
        "response": {
            "cin": "U12345MHXXXXPTCXXXXXX",
            "company_name": "DUMMY NAME PRIVATE LIMITED"
        }
    }

Response : 104

    {
        "Errorcode": 104,
        "status": "Failed",
        "msg": "Error Message",
        "response": {
            "cin": "",
            "company_name": ""
        }
    }

Passport Verification API

POST

Passport verification API is formulated to confirm the identity of an individual by verifying his/her personal details mentioned on the passport.

Name: Passport verification API


Type: POST


Request: https://planapi.in/Api/Ekyc/PassportVerification

Parameter Type Position # Description
TokenID string Header Required Enter Genrated TokenId Credentials
ApiUserID string Header Required Enter given USERID Credentials
ApiPassword string Header Required Enter given PASSWORD Credentials
File_No string Body Required Enter File_No
DateofBirth string Body Required Enter DateofBirth 01-12-2000
ApiMode string Body Optional 0 for Test API/1 for Prodution

Response : 100

                                {
        "Errorcode": 100,
        "status": "Success",
        "msg": "done",
        "response": {
            "holder_name": "DUMMY NAME",
            "dob": "01-11-2000",
            "passport_number": "111111",
            "application_date": "01-11-2000",
            "file_number": "07AAECR29"
        }
    }

Response : 104

    {
        "Errorcode": 104,
        "status": "Failed",
        "msg": "",
        "response": {
            "holder_name": "",
            "dob": "01-11-2000",
            "passport_number": "",
            "application_date": "",
            "file_number": ""
        }
    }

Udyog Aadhaar API

POST

The Udyog Aadhaar Verification API enables seamless validation and retrieval of detailed information for businesses registered under India’s Udyog Aadhaar scheme. By submitting a valid Udyog Aadhaar Number (UAN), users can access authentic business registration data, including enterprise information, plant addresses, and industrial classification details.

Name: Udyog Aadhaar Details


Type: POST


Request: https://planapi.in/Api/Ekyc/UdyogAadhaar

Parameter Type Position # Description
TokenID string Header Required Enter Genrated TokenId Credentials
ApiUserID string Header Required Enter given USERID Credentials
ApiPassword string Header Required Enter given PASSWORD Credentials
UdhyogAadharNumber string Body Required Enter Your Udhyog Aadhar Number
ApiMode string Body Required Enter Your ApiMode

Response : 200

{
    "status_code": 100,
    "message_code": "Success",
    "message": "done",
    "data": {
        "uan": "UDYAM-GJ-25-000000",
        "certificate_url": "",
        "main_details": {
            "enterprise_type_list": [
                {
                    "classification_year": "2023-24",
                    "enterprise_type": "Micro",
                    "classification_date": "2023-05-09"
                },
                {
                    "classification_year": "2022-23",
                    "enterprise_type": "Micro",
                    "classification_date": "2022-06-26"
                },...
            ],
            "name_of_enterprise": " INDUSTRIES",
            "major_activity": "Manufacturing",
            "social_category": "General",
            "date_of_commencement": "2012-10-17",
            "dic_name": "XXXXXX",
            "state": "AAAAAA",
            "applied_date": "2022-04-16",
            "flat": "106/9",
            "name_of_building": "3RD PHASE",
            "road": "XXXXX",
            "village": "XXXXX",
            "block": "NA",
            "city": "VAPI",
            "pin": "XXXXX",
            "mobile_number": "XX*****XXX",
            "email": "XXXXXXXXX@GMAIL.COM",
            "organization_type": "Proprietary",
            "gender": "Male",
            "date_of_incorporation": "0000-10-17",
            "msme_dfo": "XXXXXXX",
            "registration_date": "00000-04-16"
        },
        "location_of_plant_details": [
            {
                "unit_name": "XX*************XX",
                "line_1": "C-104, 14/3",
                "building": "XXXXXXXXXX SOCIETY",
                "village": "XXX",
                "street": "",
                "road": "BEHIND AAAAA COLLEGE",
                "city": "AAAAA",
                "pin": "000000",
                "state": "AAAAAA",
                "district": "AAAAA"
            },...
        ],
        "nic_code": [
            {
                "nic_2_digit": " 0; management consultancy activities",
                "nic_4_digit": "Management consultancy activities",
                "nic_5_digit": "Management consultancy activities",
                "activity_type": "Services",
                "added_on": "0000-04-16"
            },...
        ]
    }
}

Response : 404

{
    "status_code": 104,
    "message_code": "Failed",
    "message": "Please check with all required parameters",
    "data": {
        "uan": null,
        "certificate_url": null,
        "main_details": null,
        "location_of_plant_details": null,
        "nic_code": null
    }
}