E-Invoice/E-WayBill APIs

API – Get GSTIN

This API is used to get details of GSTIN.

URL

GET https://app.octagst.com/api/einvoice/getgstin?gstin={value}&partygstin={value}

Query Parameters

NameDescriptionType
gstinIt specifies GSTIN of seller GSTINMandatory
partygstinIt specifies GSTIN whose details to be fectchedMandatory

Success Response

Response payload will contains the success status along with IRN information.

{
  "Success": true,
  "Gstin": "24ACPPM5624F1ZK",
  "TradeName": "SHASTRI  TROLLY WORKS",
  "LegalName": "MANHARBHAI VISHNUBHAI MISTRI",
  "AddrBnm": "TALUKDARI HOSTEL",
  "AddrBno": "SHASTRI TROLLY WORKS",
  "AddrFlno": "",
  "AddrSt": "ASHRAM ROAD",
  "AddrLoc": "NADIAD",
  "StateCode": 24,
  "AddrPncd": 387002,
  "TxpType": "REG",
  "Status": "ACT",
  "BlkStatus": null
}

Status will have values as 'ACT' (Active) or 'CNL' (Cancelled) or 'INA' (Inactive) or 'PRO' (Provision).

The blkStatus indicates the status of blocking of generation of E Way Bill and will have following values

  • U or null for Unblocked
  • B for blocked

E-Waybill generation is blocked for tax payers who have not filed the returns for last two months.

Failure Response

If API request fails for some reason, response payload will contain the failure status and a list of errors.

{
  "Success": false,
  "Errors": [
    {
      "Code": "ERR_CODE_1",
      "Message": "ERR MESSAGE 1"
    },
    {
      "Code": "ERR_CODE_n",
      "Message": "ERR MESSAGE n"
    }
  ]
}