Parent API: GST API Quickstart guide Authentication guide

GSTR-1 B2B Invoices API

Q: What parameters and payload format are required for Get B2B Invoices?

Requests are submitted via HTTP GET to '/gstr1/b2b'. Required parameters: 'email' (query parameter), 'gstin' (query parameter), 'retperiod' (query parameter), 'gst_username' (header parameter), 'state_cd' (header parameter), 'ip_address' (header parameter), 'txn' (header parameter), 'client_id' (header parameter), 'client_secret' (header parameter). No request body payload is required for this call.

Q: What response status codes and format does Get B2B Invoices return?

For Get B2B Invoices (GET '/gstr1/b2b'), responses are returned in JSON format ('application/json'). Documented response codes in the specification include: HTTP 404 (Not Found. If requested entity is not found or if requested API is not found.), HTTP 500 (Internal server error).

GEThttps://apisandbox.whitebooks.in/gstr1/b2b

Getting all B2B invoices for a return period.

Parameters

query parameters

emailstringrequired

actionrequiredstringoptional

Status filter for filtering the invoices. Action_required = Y, fetches the invoices where tax payer need to take action (Accept/Reject). Already accepted or uploaded invoices can be fetched by using action_required=N filter.

gstinstringrequired

GSTIN of the taxpayer

retperiodstringrequired

Return Period format MMYYYY

ctinstringoptional

CTIN of the taxpayer

fromtimestringoptional

From time format DD-MM-YYYY,20-12-2016

header parameters

gst_usernamestringrequired

GST UserName

state_cdstringrequired

State Code

ip_addressstringrequired

IP Address

txnstringrequired

Transaction

client_idstringrequired

Client ID

client_secretstringrequired

Client Secret

Response

Not Found. If requested entity is not found or if requested API is not found.

Frequently Asked Questions

Requests are submitted via HTTP GET to /gstr1/b2b. Required parameters: email (query parameter), gstin (query parameter), retperiod (query parameter), gst_username (header parameter), state_cd (header parameter), ip_address (header parameter), txn (header parameter), client_id (header parameter), client_secret (header parameter). No request body payload is required for this call.

For Get B2B Invoices (GET /gstr1/b2b), responses are returned in JSON format (application/json). Documented response codes in the specification include: HTTP 404 (Not Found. If requested entity is not found or if requested API is not found.), HTTP 500 (Internal server error).

Getting all B2B invoices for a return period.

Save GSTR1 data

Get B2CLA Invoices

GET/gstr1/b2b

1const response = await fetch('https://apisandbox.whitebooks.in/gstr1/b2b?email=value&actionrequired=value&gstin=value&retperiod=value&ctin=value&fromtime=value', {

2 method: 'GET',

3 headers: {

4 gst_username: "value",

5 state_cd: "value",

6 ip_address: "value",

7 txn: "value",

8 client_id: "value",

9 client_secret: "value"

10},

11});

13const data = await response.json();

14console.log(data);

No example available.