"# GSTNVerification"

GST Verification System

A Node.js based GST verification system that fetches real taxpayer details from the GST portal using GSTIN and captcha authentication.

This project includes:

• Backend API (Node.js + Express)
• Frontend interface for GST verification
• Captcha handling
• Automatic captcha refresh
• Loading indicator for better UX

Features

• Verify GSTIN directly from the official GST portal
• Captcha based authentication
• Real-time GST taxpayer details
• Loading spinner during verification
• Automatic captcha refresh on error
• Simple frontend UI
• Easy API integration into other websites

Tech Stack

• Node.js
• Express.js
• Axios
• Tough-cookie
• HTML
• CSS
• JavaScript

Project Structure

project/
│
├── server.js
├── routes/
│   └── gstRoutes.js
├── controllers/
│   └── gstController.js
├── services/
│   └── gstService.js
└── public/
    ├── index.html
    ├── style.css
    └── script.js

Installation

Clone the repository:

git clone https://github.com/yourusername/gst-verification-system.git
cd gst-verification-system

Install dependencies:

npm install

Start the server:

npm start

The server will run at:

http://localhost:5001

Usage

1. Open the website in your browser
2. Enter the GST number
3. Enter the captcha
4. Click Verify GST
5. GST taxpayer details will be displayed

API Endpoints

Get Captcha

GET /api/v1/getCaptcha

Response:

{
  "sessionId": "session-id",
  "image": "captcha-base64-image"
}

Get GST Details

POST /api/v1/getGSTDetails

Request Body:

{
  "sessionId": "session-id",
  "GSTIN": "GST_NUMBER",
  "captcha": "CAPTCHA_TEXT"
}

Response:

{
  "gstin": "GST_NUMBER",
  "lgnm": "Legal Name",
  "tradeNam": "Trade Name",
  "sts": "Status",
  "rgdt": "Registration Date",
  "ctb": "Business Type"
}

Disclaimer

This project interacts with the GST portal for educational and development purposes. The GST portal may change its API, captcha mechanism, or access policies at any time.

For production-grade applications, it is recommended to use official APIs provided by GST Suvidha Providers.

Contribution

Contributions are welcome.

1. Fork the repository
2. Create a new branch
3. Make changes
4. Submit a pull request <<<<<<< HEAD

=======

6a8d5dfd4f876573c5b8d52073bbccd768f0b418