Skip to main content
GET
/
gst
/
compliance
/
tax-payer
/
gstrs
/
gstr-1
/
b2ba
/
{year}
/
{month}
GSTR-1 B2BA
curl --request GET \
  --url https://api.sandbox.co.in/gst/compliance/tax-payer/gstrs/gstr-1/b2ba/{year}/{month} \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>'
{
  "code": 200,
  "data": {
    "error": {
      "error_cd": "RET11416",
      "message": "No document found in selected financial year. Either this document exists in a different financial year or the document number is incorrect."
    },
    "status_cd": "0"
  },
  "timestamp": 1763446641000,
  "transaction_id": "3c316991-4e59-434d-a477-b971f34b1cc4"
}

ā€‹
Response body schema

View response body schema

Headers

ā€‹
authorization
string
required

GST taxpayer access token. For token-generation steps, refer to the Generate Taxpayer Session recipe, then pass the token in the authorization header.

ā€‹
x-api-key
string
required

API key for identification

ā€‹
x-api-version
string
default:1.0.0

API version

Path Parameters

ā€‹
year
string
required
ā€‹
month
string
required

Query Parameters

ā€‹
action_required
string

optional Status filter for filtering the invoices. Possible values: Y or N. Status filter for filtering the invoices. Use filter value Y to fetches the invoices where tax payer need to take action. Already accepted or uploaded invoices can be fetched by using filter value N.

Example:

"{{action_required}}"

ā€‹
from
string

From Date (DD/MM/YYYY)

Example:

"{{from}}"

ā€‹
counterparty_gstin
string

optional Counter party GSTIN

Example:

"{{ctin}}"

Response

200 - application/json

RET11416 No data found

ā€‹
code
number
Example:

200

ā€‹
data
object
ā€‹
timestamp
number
Example:

1763446641000

ā€‹
transaction_id
string
Example:

"3c316991-4e59-434d-a477-b971f34b1cc4"