GST Filings and Details - Batch APIs

Fetch comprehensive Goods and Services Tax information, including filings and filing frequency history.

Authentication and Order Setup

Before calling this API:

1. Refer to the Authentication section to obtain a valid sessionID.
2. Refer to the Create Order API documentation to create an order and obtain the corresponding order_id.

Note: Use the sessionID as the Bearer token for authentication and the order_id as a query parameter for this endpoint.

Endpoint

GET https://micro.signalx.ai/micro-check-api/gst/v2/get_gst_detailed_data
Authorization: Bearer <JWT_TOKEN>

Query parameters

Parameter	Type	Required	Description
order_id	String	Yes	Unique UUID of the order.
page	Integer	Yes	Page number (starting at 1).
page_size	Integer	Yes	Number of records per page.

cURL Example

curl --location 'https://micro.signalx.ai/micro-check-api/gst/v2/get_gst_detailed_data?order_id=3d73bea2-ec1c-4a21-9876-abc123def456&page=1&page_size=100' \
--header 'Authorization: Bearer <JWT_TOKEN>'

Sample Response

{
  "status_code": 200,
  "total": 5000,
  "total_pages": 50,
  "data": [
    {
      "gstin": "27ABACS6684C1ZY",
      "overview": {
        "legal_name_of_business": "SAMPLE VENDOR PRIVATE LIMITED",
        "constitution_of_business": "Private Limited",
        "gstin_uin_status": "Active",
        "nature_of_core_business_activity": "Manufacturer",
        "principal_place_of_business": "Mumbai, Maharashtra",
        "whether_aadhaar_authenticated": true,
        "goods": [
          { "hsn": 30049099, "description": "PHARMACEUTICAL PRODUCTS" }
        ]
      },
      "filings": [
        {
          "filing_type": "GSTR1",
          "tax_period": "January",
          "date_of_filing": "2026-02-06T00:00:00",
          "status": "Filed"
        }
      ],
      "filing_frequency_history": [
        {
          "financial_year": 2026,
          "preference": "MONTHLY",
          "tax_period_start": "2025-04-01",
          "tax_period_end": "2026-03-31"
        }
      ]
    }
  ],
  "message": "Success"
}

Top-level metadata

• status_code – e.g. 200 for success
• total – total records available
• total_pages – total pages based on page_size
• data[] – array of detailed GSTIN objects

A. Overview object (per GSTIN)

Field	Description
legal_name_of_business	Official registered legal name.
constitution_of_business	Entity type (e.g. Private Limited, Proprietor).
gstin_uin_status	Current status (Active, Cancelled, etc.).
nature_of_core_business_activity	Primary role (e.g. Manufacturer).
principal_place_of_business	Primary address.
whether_aadhaar_authenticated	true / false.
goods	Array with hsn and description entries.

B. Filings array

Each filing object typically includes:

• filing_type – e.g. GSTR1, GSTR3B
• tax_period – month of the return (e.g. January)
• date_of_filing – timestamp when the return was submitted
• status – typically Filed or Not Filed

C. Filing frequency history

• financial_year – e.g. 2026
• preference – MONTHLY or QUARTERLY
• tax_period_start / tax_period_end – date range for the preference