e-Invoice Applicability

Check whether a GSTIN is liable to generate e-invoices under Indian GST law. Returns the IRN generation status, government mandate date, taxpayer type, and state information.

Endpoint

GET /vas-api/e-invoice-applicability-v1

Authentication

Requires OAuth2 Bearer token. Get your credentials →

Request

Headers

Header	Type	Required	Description
Authorization	string	Yes	Bearer YOUR_ACCESS_TOKEN

Query parameters

Parameter	Type	Required	Description	Example
gstin	string	Yes	15-character GSTIN	29ABCDE1234F1Z5

Example request

curl

curl -X GET "https://api.api4business.com/vas-api/e-invoice-applicability-v1?gstin=29ABCDE1234F1Z5" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Python

import requests

response = requests.get(
  "https://api.api4business.com/vas-api/e-invoice-applicability-v1",
  params={"gstin": "29ABCDE1234F1Z5"},
  headers={"Authorization": "Bearer YOUR_ACCESS_TOKEN"}
)
print(response.json())

Node.js

const response = await fetch(
  "https://api.api4business.com/vas-api/e-invoice-applicability-v1?gstin=29ABCDE1234F1Z5",
  { headers: { "Authorization": "Bearer YOUR_ACCESS_TOKEN" } }
);
console.log(await response.json());

Java

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
  .uri(URI.create("https://api.api4business.com/vas-api/e-invoice-applicability-v1?gstin=29ABCDE1234F1Z5"))
  .header("Authorization", "Bearer YOUR_ACCESS_TOKEN")
  .GET().build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response

Success (200)

Field	Type	Description
ok	boolean	true if successful
responseCode	integer	HTTP status code
message	string	Status message
body.gstin	string	The GSTIN queried
body.panNo	string	PAN linked to this GSTIN
body.companyName	string	Legal name of the entity
body.companyType	string	Tax type (Regular, Composition)
body.stateCode	integer	State code number
body.statename	string	State name
body.irnStatus	string	IRN generation status (Generated, Not Generated)
body.irnGenerationDate	string/null	Date of first IRN generation, or null
body.irnGovreleasedate	string	Government mandate date for e-invoicing
body.turnover	number/null	Reported turnover, or null if unavailable

Example response

{
  "ok": true,
  "responseCode": 200,
  "message": "Transmission OK",
  "body": {
    "gstin": "29ABCDE1234F1Z5",
    "panNo": "ABCDE1234F",
    "companyName": "SAMPLE TRADING COMPANY",
    "companyType": "Regular",
    "stateCode": 29,
    "statename": "Karnataka",
    "irnStatus": "Not Generated",
    "irnGenerationDate": null,
    "irnGovreleasedate": "2021-11-14T00:00:00+05:30",
    "turnover": null,
    "tradeName": null,
    "status": null
  }
}

Response headers

Header	Description
x-request-id	Unique request identifier — log this for debugging and support

Error responses

Status	Error Code	Message	Resolution
400	400	Invalid GSTIN	Check 15-character GSTIN format
400	400	Invalid Request	Verify the gstin query parameter is present
401	401	Invalid Credentials	Access token expired — request a new one
429	429	Quota Violation	Rate limit exceeded — retry with backoff
500	500	Internal Server Error	Retry after delay
503	503	Service Not Available	GSTN service temporarily down — retry

Related

• GSTIN Status — Get full registration details
• GST Filing Details — Check filing history
• GST Overview