AI REST API V1.0

ManTech HSN Intelligence API Documentation

Base URL: https://mantechstudio.in/api/v1

Authentication

All API requests must include your ManTech API Key in the HTTP Authorization header as a Bearer token:

Authorization: Bearer mantech_live_YOUR_SECRET_KEY

POST/api/v1/ai/hsn/suggest

AI Product Classification

Classifies natural language or messy product descriptions into verified HSN/SAC tariff codes with match confidence and concise explanations.

Request Body (JSON):

{
  "product_name": "Portland Cement OPC 53 Grade",
  "description": "Construction grade cement for heavy building",
  "industry": "Construction",
  "limit": 5
}

cURL Example:

curl -X POST "https://mantechstudio.in/api/v1/ai/hsn/suggest" \
  -H "Authorization: Bearer mantech_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_name": "OPC cement 53 grade"}'

Success Response (HTTP 200):

{
  "success": true,
  "data": {
    "input": {
      "product_name": "OPC cement 53 grade"
    },
    "suggestions": [
      {
        "hsn_code": "2523",
        "description": "Portland cement, aluminous cement, slag cement...",
        "chapter": "Chapter 25",
        "type": "goods",
        "gst_rate": 28,
        "match_confidence": "high",
        "score": 0.94,
        "match_reason": "Trade terms (opc, cement) match official CBIC HSN 2523."
      }
    ],
    "needs_more_information": false,
    "disclaimer": "AI-assisted HSN code discovery..."
  },
  "meta": {
    "request_id": "req_1724956789_102",
    "data_version": "2026.08.CBIC",
    "model_version": "hsn-intelligence-v1.0"
  }
}

POST/api/v1/ai/hsn/feedback

Classification Feedback

Submit developer or user acceptance/rejection feedback to continuously evaluate and improve retrieval accuracy.

{
  "request_id": "req_1724956789_102",
  "suggested_hsn": "2523",
  "feedback": "accepted"
}

Loading…