Laststatus Method POST

The LASTSTATUS method allows a company to check on their past consent and request calls to see if a taxpayer's data is waiting on the IRS to release it, available in the TaxStatus system, or has been rejected by the IRS. If rejected, this typically means there was a problem with the information provided. The most common error is an incorrect address (muat be the address of the taxpayer on their last tax filing), or the name is mispelled. You must contact the taxpayer and have them review all the fields for correctness and resend the consent or request.

Request Path

Submit all laststatus requests to the following path.

Path

You will obtain the API endpoint after you register on your account page.

Headers

Each request must an OAuth2 tokan and your company Id, assigned by TaxStatus, in the header.

Authorization
euid

Query String Parameters

Query string parameters are not supported on this method.

/Laststatus Request application/json

Post the following payload to get a list of allowable taxpayers and status, for the company, within the timeperiod supplied. If no date is supplied, then the time periiod is last 24 hours.

Attributes

  • companyId* The company Id of the company this call is on behalf of. If the call is not on behalf of another company, then the registered company Id TaxStatus assigned during the registration process used in the euid field in the header.
  • dateBack* The date, in the past, the system will use as the begining range. The current day will be the end range. Leave blank to go back 2 weeks.

Example call request body for the laststatus method.

{ "companyId": "enco45100", "dateBack": "10/01/2021", }

Response Body application/json

Attributes

  • TIN The Tax Identification Number sent in the request
  • Name The last name or business name of the taxpayer
  • Status The status of the taxpayer's data:
    • Available - Data is available to be pulled from the TaxStatus system
    • Wainting on Taxpayer - The taxpayer has not yet signed the consent that was sent to them
    • Wainting on IRS - The IRS has yet to release the data for the taxpayer
    • Rejected by IRS - The IRS has rejected the information on the consent. You must have the taxpayer reivew their information and then resubmit the consent or request.

Example response body for the laststatus method

[{ "TIN": "XXXXX0001", "Name": "SPENCE", "Status": "Waiting on IRS" }, { "TIN": "XXXXX2222", "Name": "SMITH", "Status": "Available" }, { "TIN": "XXXXX7890", "Name": "BARTON", "Status": "Available" }, { "TIN": "XXXXX5034", "Name": "SANFORD", "Status": "Rejected by IRS" }, { "TIN": "XXXXX0004", "Name": "GENERAL CONTRACTORS INC.", "Status": "Waiting on IRS" }, { "TIN": "XXXXX2021", "Name": "LOCU INC", "Status": "Waiting on IRS" }, { "TIN": "XXXXX7777", "Name": "SOUTHERN COMPANY, LLC", "Status": "Available" }, { "TIN": "XXXXX7777", "Name": "BONES N SCONES", "Status": "Waiting on Taxpayer" }, { "TIN": "XXXXX6666", "Name": "THE BUYERS GROUP", "Status": "Available" }]

The reponse codes for the laststatus call are standard HTML response codes.

Response Codes

HTTP Status Code Description Explanation
200 Accepted/OK The request has been accepted with no issues
400 Bad Request You are missing some required fields or the Json in the body is missing or malformed
403 Forbidden You do not have authorization to make this call. Possibly your comapany Id is invalid or you are calling on behalf of a company with which you dont have authority.