Status

Once you have shared the 8453-EMP electronically with your client, you can use this endpoint to retrieve the signature status.

GET Form8453EMP/Status 

Request Params

Field	Type	Description
RecordId	Guid	A Unique Record Identifier generated by TaxBandits when a 94X return is created

Request Params

Sample 1

When the 8453-EMP form is pending the client’s (taxpayer) signature.

"Form8453EMP/Status?RecordId=babf0c22-f13b-4d2a-ae6e-8022f4def4a2"

Sample 2

When both the client (taxpayer) and paid preparer have e-signed the 8453-EMP form.

"Form8453EMP/Status?RecordId=babf0c22-f13b-4d2a-ae6e-8022f4def4a2"

Sample 3

When the client (taxpayer) has declined the 8453-EMP e-sign request.

"Form8453EMP/Status?RecordId=d3643ae5-a55a-40aa-ab78-3b2f9ca7b7bb"

Sample 4

When the RecordId provided in the request is invalid.

"Form8453EMP/Status?RecordId=13643ae5-a55a-40aa-ab78-3b2f9ca7b7bb"

Response Body

Field	Type	Description
RecordId	Guid	A Unique Record Identifier generated by TaxBandits when a 94X return is created
RecordStatus	string	Status of Form 8453-EMP
StatusMessage	string	Shows Detailed Status message of Form 8453-EMP
Errors	object[]	Shows detailed error information
Id	string	Error ID number. This ID is assigned by TaxBandits and it is unique for each error.
Name	string	Name of the errored node.
Message	string	Shows the error message.

Response JSON

Response 1

{
    "RecordId": "babf0c22-f13b-4d2a-ae6e-8022f4def4a2",
    "RecordStatus": "Not Signed",
    "StatusMessage": "The tax-payer has not signed yet",
    "Errors": null
}

Response 2

{
    "FilePath": "https://s3.amazonaws.com/taxbandits-dev-api/babf0c22-f13b-4d2a-ae6e-8022f4def4a2.Pdf",
    "RecordId": "babf0c22-f13b-4d2a-ae6e-8022f4def4a2",
    "RecordStatus": "Completed",
    "StatusMessage": "Your 8453EMP form is completed",
    "Errors": null
}

Response 3

{
    "RecordId": "d3643ae5-a55a-40aa-ab78-3b2f9ca7b7bb",
    "RecordStatus": "Declined",
    "StatusMessage": " Wages, tips, and other compensation Need to be Changed",
    "Errors": null
}

Response 4

{
    "RecordId": "13643ae5-a55a-40aa-ab78-3b2f9ca7b7bb",
    "RecordStatus": null,
    "StatusMessage": "The resource you have specified cannot be found",
    "Errors": [
        {
            "Id": "F01-100180",
            "Name": "NoRecords",
            "Message": "No records found "
        }
    ]
}