Laststatus V2 Method POST

This call works with our new one-link consent process to allow you to not only get the status of one of your taxpayers, but also tie the Client Id, we generated, to the taxpayer in your system. This will allow you to make calls on behave of the taxpayer without using SSN or any personally identifiable information (PII).

The LASTSTATUS V2 method, like the V1 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 (v2) 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.

/V2/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 30 days. Maximum time back is 30 days.

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 4 weeks.

Example call request body for the laststatus method.

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

Response Body application/json

Attributes

  • TIN The Client Id, generated from TaxStatus, used to identify the taxpayer is subsequent calls.
  • First Name The first name or business name of the taxpayer
  • Last Name The last name or business name of the taxpayer
  • Email The email address of the taxpayer
  • Status The status of the taxpayer's data:
    • Available - Data is available to be pulled from the TaxStatus system
    • Waiting 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 v2 method

[ { "TIN": "0B7LS34HQJ48KG7", "FirstName": "ROBERT", "LastName": "SMITH", "Email": "rob@aol.com", "Status": "Available" }, { "TIN": "0ZBSGCCNDMZSOUV", "FirstName": "SAMMT", "LastName": "SMITH", "Email": "sammy@gmail.com", "Status": "Available" }, { "TIN": "13TP5Y1TRRSYV9M", "FirstName": "MARGRET", "LastName": "FLOWERS", "Email": "mm456@gmail.com", "Status": "Waiting on IRS" }, { "TIN": "1EPUNMGEAM11SOC", "BusinessName": "EXUMBER INC", "Status": "Available" }, { "TIN": "1J9VZ9K3BZWD9WB", "FirstName": "HELEN", "LastName": "ELMS", "Email": "try@gmail.com", "Status": "Available" }, { "TIN": "1EPUNMGEAM11SOC", "BusinessName": "ACME INC", "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.