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 has been released by the IRS and is in the TaxStatus system, and available to be retrieved by the other methods used to retrieve data.


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 24 hours.

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, either Available if data can be pulled from the system, or Wainting on IRS if data is unavailble.

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": "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": "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.