Skip to main content
Version: 1.7.3

BOI Report Status Change

When FinCEN processes your BOI report, you can configure webhooks to receive status notifications.

Steps to Configure Webhook​ for BOIR:​

  1. Log in to the Developer Console. Navigate to Settings > Webhook Notifications.
  2. Click ‘Add Webhook’. Configure Webhooks for the event type ‘BOI Report Status Change’.
  3. Enter the callback URL and click on the Submit button. Ensure that the callback URL you enter is valid, as the API will authenticate this URL by posting a sample JSON. The URL will be activated only when we receive the 200 response. You must follow these best practices to have a valid callback URL for Webhook.
  4. Then, provide a Notify email. This email will be used by TaxBandits to notify you regarding any failed attempts of Webhook posting.

Here is the sample Webhook Post:

Here is the sample of Webhook if your BOIR is accepted by FinCEN:

{
    "SubmissionId": "a232b5fe-b6cb-4bc7-a17a-0d907811e56c",
    "ReportNumber": "109735",
    "ReportType": "INITIAL",
    "ReportStatus": "ACCEPTED",
    "FilingReference": {
        "FiledWith": "FinCEN",
        "BOIRId": "325325",
        "SubmissionTrackingId": "235235",
        "BOITranscript": "UserFiles/66badf6c02714f1adeda218c/ec84d52e-3984-49c5-aec-5aa5e53eccbetranscript/Transcript_66fe1f8a738372f3b37a0fc7.pdf",
        "FinCENID": null
    },
    "StatusTime": "2024-07-22T06:49:48.4429266-04:00",
    "RejectedBy": null,
    "RejectionError": null
}

Respond to Webhook Post from API​​

You must respond to the Webhook post by sending an HTTP 200 OK Response. Any other code other than 200 will be treated as an incomplete call. This API does not support 301 redirects, which will be treated as an error. Learn more

You are required to initiate a response to our Webhook request within 5 seconds, if not, the request will be treated as timeout. If the API doesn’t receive a response during the 5-second time window or in case of an error, it will attempt to retry the connection a total of 9 times within 24 hours.

Before you respond to a Webhook request, you must validate if the request was sent from TaxBandits. To learn how to validate Webhook requests, click here.