Status
Status
This endpoint is used to retrieve the status of the 15397 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 Form15397/status Request Params
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier of a submission |
Response Body
| Field | Type | Description |
|---|---|---|
| StatusCode | number | HTTP status code of the response (e.g., 200, 400, 500). |
| StatusName | string | Name of the status code |
| StatusMessage | string | Detailed message describing the outcome of the delete request. |
| SubmissionId | Guid | Unique identifier of the submission that was attempted to be deleted. |
| Form15397Status | string | Current status of the Form 15397 submission after the delete request (e.g., “Deleted”, “Failed”, “NotFound”). |
| StatusTs | string | Date and time (timestamp) when the status was last updated. |
| Errors | object[] | Array of error details, returned if the request failed validation or processing. |
| Id | string | Unique identifier of the validation or processing error. |
| Name | string | Short name of the error. |
| Message | string | Detailed description of the error. |
Request Params
"Form15397/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",
"Form15397Status": "FAXED_TO_IRS",
"StatusTs": "2025-08-05 09:53:23 -04:00",
"Errors": null
}
Possible statuses are: ORDER_RECEIVED, FAXED_TO_IRS