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.
/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. |