Get IMS Request Status

Route

/basic/gstn/{flynn-version}/taxpayerapi/{gstn-api-version}/returns/ims/REQSTS?gstin={gstin}&int_tran_id={internalTransactionId}

• active ‘flynn-version’: v1.0
• method: GET

URL Parameters

Name	Description	Type
flynn-version	version of the API for example, v1.0	string
gstn-api-version	as per the version of the GST API Documentation for example, v0.3	string

Query Parameters

Name	Description	Type	Mandatory
gstin	GSTIN of the taxpayer for example, 33GSPTN0791G1Z5	string	Yes
int_tran_id	Internal Transaction Id (Reference ID received in the response of IMS Save and Reset API) for example, 0032e479bcb644c	string	Yes

Headers

All required headers to make an authenticated API call.

Response

200

Successful response will be the same payload as per the ‘GST API Documentation’.

Example

{
  "status": "1",
  "data": {
    "status_cd": "PE",
    "transTypCd": "SAV",
    "proc_cnt": "10",
    "err_cnt": "3",
    "err_cd": "",
    "err_msg": "",
    "error_report": {
      "b2b": [
        {
          "stin": "32TAAOA2947A1Z7",
          "error_cd": "IMSSAV0010",
          "error_msg": "Either previous action is incorrect/ invoice might have edited by supplier",
          "inv": [
            {
              "rtnprd": "042023",
              "inum": "invoice-b2b"
            }
          ]
        }
      ],
      "dn": [
        {
          "stin": "32TAAOA2947A1Z7",
          "error_cd": "IMSSAV0010",
          "error_msg": "Either previous action is incorrect/ invoice might have edited by supplier",
          "inv": [
            {
              "rtnprd": "042023",
              "inum": "invoice-dn"
            }
          ]
        }
      ]
    }
  },
  "error": null,
  "info": null,
  "additionalInfo": null,
  "alert": null
}

Errors

Invalid GSTIN Format

{
  "status": "0",
  "data": null,
  "error": {
    "message": "err-invalid-gstin-format",
    "type": "ClientRequest",
    "args": {
      "parameter-name": "gstin"
    }
  },
  "info": null,
  "additionalInfo": null,
  "alert": null
} 

Invalid GSTN API Version

{
  "status": "0",
  "data": null,
  "error": {
    "message": "err-invalid-gst-returns-api-version",
    "type": "ClientRequest",
    "args": {
      "version": "v8.0"
    }
  },
  "info": null,
  "additionalInfo": null,
  "alert": null
}   

GSTN Error

{
  "status": "0",
  "data": null,
  "error": {
    "message": "err-gstn-returned-error",
    "type": "Gstn",
    "args": {
      "gstn-err": {
        "status-code": "0",
        "error-code": "RET11402",
        "message": "Unauthorized User"
      }
    }
  },
  "info": null,
  "additionalInfo": null,
  "alert": null
}

Response Status	Description
400	Invalid GSTIN format in the request
400	Invalid GSTN API Version
404	Invalid GSTIN
502	Error at GSTN end

Common Errors

check here for other common errors.