Filing webhooks
TaxStreem delivers filing outcomes asynchronously via webhooks. Register your webhook URL in the TaxStreem dashboard under Settings → Webhooks.
VAT webhook events
| Field | Type | Description |
|---|---|---|
| vat.filing.success | event | VAT return accepted by NRS. Includes filing reference number and PRN for payment. |
| vat.filing.failed | event | VAT return rejected by NRS. Includes reason code and corrective guidance. |
Webhook payload
{
"event": "vat.filing.success",
"data": {
"filingId": "fil_vat_001",
"reference": "NRS-REF-2025-00123",
"prn": "PRN-9876543210",
"month": 3,
"year": 2025,
"totalVatPayable": 15625,
"status": "success",
"timestamp": "2025-03-20T10:05:23Z"
}
}Acknowledging webhooks
Your endpoint must return a 200 OK within 5 seconds. TaxStreem will retry failed deliveries up to 3 times with exponential backoff. Validate the webhook signature using the X-TaxStreem-Signature header.