Status

Status

This endpoint is used to retrieve the status of the 8809 extension request you’ve submitted through the TaxBandits API. Your request JSON must include the ‘SubmissionId’ corresponding to the extension request you want to check the status for.

Note:

As an alternative to this endpoint, you can configure webhooks for the event type ‘E-file Status Change’ to receive automatic notifications. Learn more

GET Form8809/Status 

Run in Postman

Request Params

Field	Type	Description
SubmissionId	Guid	Unique identifier of a submission

Response Body

Field	Type	Description
StatusCode	number	HTTP status code returned by the API (e.g., 200, 300, 400).
StatusName	string	Name of the HTTP status
StatusMessage	string	Detailed message explaining the status of the request.
SubmissionId	Guid	Unique identifier of the submission, generated by TaxBandits.
BusinessId	Guid	Unique identifier of the business associated with the submission.
PayerRef	string	User-defined reference identifier for the payer linked to the submission.
Form8809Status	string	The IRS status of the Form 8809 submission.
StatusTs	string	Date and time (ISO 8601 format) when the status was last updated.
Errors	object[]	Array of error objects (if any) containing details of validation or processing errors.
Id	string	Error code for a specific validation issue.
Name	string	Name of the validation error.
Message	string	Description of the error.

Request Params

"Form8809/Status?SubmissionId=e88e7f1d-7ae5-43b6-99f6-38d85664035a"

Response JSON

Success Response - This is a sample response for successful API requests.

{
 "StatusCode": 200,
 "StatusName": "Ok",
 "StatusMessage": "Successful API call",
 "SubmissionId": "000e9b21-c0fd-421c-867e-93ef54d37b33",
 "Form8809Status": "TRANSMITTED",
 "StatusTs": "2021-08-05 09:53:23 -04:00",
 "Errors": null
}