Bulk Verification API

The Bulk Verification API runs one kind of check on a list of identifiers in a single request. Choose the service in the path, pan for PAN verification, pan-to-udyam for PAN to Udyam, pan-to-cin for PAN to CIN or gst for GST verification, then send a batch name and 5 to 10,000 distinct values. Repeats and blanks are dropped for you before the count is taken.

The batch is accepted straight away with a batch_id and runs in the background in chunks. You follow its progress from the batch list (status, counts per outcome and progress_percent) and read the rows as they finish. With include_result=true each successful row carries the full result in the same data schema as the stand-alone check, so the code that reads a single PAN or GSTIN answer also reads a bulk row.

Use it to check a whole vendor master, dealer network or borrower book at once, instead of a loop of single calls with your own retries and bookkeeping.

How it works

1. 1

   Your server sends POST /bulk-verification-v2/{serviceType}/create with serviceType pan, pan-to-udyam, pan-to-cin or gst, a batch name and the values. Outside 5 to 10,000 distinct values the batch is refused with 400 invalid_request before any charge.

2. 2

   The batch is charged upfront from your prepaid wallet, per unique value, and the answer carries data.batch_id with outcome pending.

3. 3

   Rows are checked against live records in the background. A row that could not be answered is retried, then followed up by our team, and refunded if it cannot be checked. Watch progress_percent on GET /bulk-verification-v2/{serviceType}, or receive bulk_batch.completed on your webhook endpoint.

4. 4

   Read the rows with GET /bulk-verification-v2/{serviceType}/{batchId}/records (add include_result=true for full results) or one row with GET /bulk-verification-v2/record/{recordId}; every row has its own PDF report.