GSTGST Return Status

GST Return Filing Status Check

Check whether a business has filed GST returns on time. Track GSTR-1, GSTR-3B, and other filing statuses by GSTIN.

curl -X GET "https://production.deepvue.tech/v1/verification/gstin/track-gstr?gstin_number=example_string&financial_year=example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN (JWT)" \
  -H "x-api-key: YOUR_API_KEY"
{
  "code": 200,
  "timestamp": 1738051954177,
  "transaction_id": "09d1a4fd-be05-44f4-a4b6-6c14cf375d1f",
  "sub_code": "SUCCESS",
  "message": "GSTR Status Fetched Successfully.",
  "data": {
    "gstin": "29AAACT2727Q1ZS",
    "filing_status": [
      {
        "return_type": "GSTR1",
        "financial_year": "2024-2025",
        "tax_period": "December",
        "date_of_filing": "2025-01-11",
        "status": "Filed",
        "mode_of_filing": "ONLINE"
      }
    ]
  }
}
GET
/v1/verification/gstin/track-gstr
GET
Bearer Token (JWT)
Bearer Tokenstring
Required

ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .

ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
API Key (header: x-api-key)
x-api-keystring
Required

The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.

The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token (JWT). ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .

header
x-api-keystring
Required

API Key for authentication. The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.

Query Parameters

Responses

codeinteger
timestampinteger
transaction_idstring
sub_codestring
messagestring
dataobject

Overview

The Track GST Return API enables businesses to monitor the filing status of Goods and Services Tax Returns (GSTRs) by accepting a GSTIN and financial year as inputs. The system then responds with comprehensive details about all GSTRs submitted by that entity during the specified period.

A GST entity periodically and rightly filing GSTRs is a positive indication about its business and compliance performance. Monitoring GSTR submission patterns provides meaningful insight into an organization's compliance posture.

The API returns filing information including return type designations, associated tax periods, filing dates, current status (such as Filed or Pending), and the submission method employed.

One Access Token will be valid for only 24 hours. After 24 hours, you can renew the token by using the Authorize Endpoint.