Update Method POST

The UPDATE method allows a company to request an update of all the taxpayer's information. This call will get the latest transcripts and transactions from the IRS.


Request Path

Submit all update 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.


/Update Request application/json

Post the following JSON object in the body.

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.
  • tin* 9-digit tax id (no spaces or hypens) of the individual or business taxpayer
  • isCompany* Zero (0) if tin is an SSN or one (1) if tin is an EIN

Example call request body for the laststatus method.

{ "companyId": "U3YCILS0YQTVNIC", "tin": "222222222", "isCompany": 0 }

Response Body application/json

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.