Job status webhook

Receive a notification when a Form 16 or Form 16A certificate job succeeds or fails.

WEBHOOK CertificateJobStatus

JSON

Form 16 Job Succeeded

{ "data": { "@entity": "in.co.sandbox.tds.compliance.certificate.job", "job_id": "f24cd229-42c8-43de-af79-8ce2d3c4c3db", "tan": "AHMA09719B", "quarter": "Q4", "form": "24Q", "financial_year": "FY 2023-24", "status": "succeeded", "remember_me": false, "created_at": 1716870600000, "updated_at": 1716871500000, "certificate_zip_urls": [ "https://in-co-sandbox-tds-compliance-certificate-test.s3.ap-south-1.amazonaws.com/tan/financial_year/quarter/form/5167fdff-507b-486b-98d1-6e6ae46776f2/1_form16_pdf.zip", "https://in-co-sandbox-tds-compliance-certificate-test.s3.ap-south-1.amazonaws.com/tan/financial_year/quarter/form/5167fdff-507b-486b-98d1-6e6ae46776f2/2_form16_pdf.zip" ] } }

Webhooks fire only when a certificate job transitions to succeeded or failed.

To configure your webhook URL and validate the x-sandbox-signature header, see the webhooks guide.

Body

application/json

data · Job Succeeded · object

Job details at the time of the status change.

Job Succeeded

Job Failed

Show child attributes

Response

200

Return any 2xx status to acknowledge receipt. Sandbox retries delivery on non-2xx responses.