Skip to main content
POST
/
gst
/
analytics
/
gstr-2b-reconciliation
Reconcile GSTR-2B Job
curl --request POST \
  --url https://test-api.sandbox.co.in/gst/analytics/gstr-2b-reconciliation \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "@entity": "in.co.sandbox.gst.analytics.gstr-2b_reconciliation.request",
  "gstin": "24EGCAZ2081S7Z4",
  "year": 2023,
  "month": 12,
  "filing_preference": "monthly",
  "reconciliation_criteria": "strict"
}
'
{
  "code": 200,
  "transaction_id": "d3d19997-c48a-4867-95b9-5a77c3567098",
  "data": {
    "@entity": "in.co.sandbox.gst.analytics.gstr-2b_reconciliation.job",
    "job_id": "d3d19997-c48a-4867-95b9-5a77c3567098",
    "gstin": "24EGCAZ2081S7Z4",
    "year": 2023,
    "month": 12,
    "filing_preference": "monthly",
    "reconciliation_criteria": "strict",
    "status": "created",
    "gstr_2b_url": "https://in-co-sandbox-gst-test-storage.s3.ap-south-1.amazonaws.com/gstr-2b-reconciliation/gstr-2b.json",
    "purchase_ledger_url": "https://in-co-sandbox-gst-test-storage.s3.ap-south-1.amazonaws.com/gstr-2b-reconciliation/purchase-ledger.json",
    "created_at": 123
  },
  "timestamp": 123
}
This endpoint is part of a job-based async workflow. See the job-based API workflow guide for job creation, payload upload, and status polling.
You upload two files after the job is created: the GSTR-2B JSON export and the purchase ledger workbook.

Upload file schemas

Use these schemas to validate both files before you upload them to the signed URLs returned by this endpoint.

View GSTR-2B upload schema

View purchase ledger schema

The GSTR upload schema file lists the available schema versions with their valid_from dates.

Headers

authorization
string
required
x-api-key
string
required
x-api-version
string
default:1.0.0

Body

application/json
@entity
string
required

Entity name

Allowed value: "in.co.sandbox.gst.analytics.gstr-2b_reconciliation.request"
gstin
string
required

GSTIN of the taxpayer

Pattern: ^([0-9]{2}[0-9A-Z]{13})$
year
integer
required

Year e.g. 2020

month
integer
required

Month e.g. 10

reconciliation_criteria
enum<string>
required

Preference for the reconciliation strictness. Possible values: strict, moderate, flexible

Available options:
strict,
moderate,
flexible
filing_preference
enum<string>

Return filing preference for the reconciliation job.

Available options:
monthly

Response

200 - application/json

200 Job Created

code
integer
transaction_id
string
data
object
timestamp
integer