Request Path

Submit all business requests to the following 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.

Query String Parameters

Query string parameters are not supported on this method.

/Business Request application/json

This method uses the Tax Identification Number (EIN) for a business to retrieve all relevant tax data points by period (YYYYMM).

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.
• ein* 9-digit tax id (no spaces or hypens) of a business

Example call request body for the individual method

Response Body application/json

The following is a list of all possible fields. NULL fields are not returned.

Attributes

• EIN The SSN sent in the request
• Data An array of objects for each period available from the IRS
  • Period The tax year and month this list applies to in YYYYMM format
  • Form Indicates if fomr is ANNUAL or Quarterly
  • FormType Indicates the IRS form type (ACTR, RETR, RECA, CIVPEN, etc.)
  • UpdateDate The date the data was last retrieved from the IRS
  • FileingStatus The filing status of the business
  • AnnualForm The annual form the business files
  • AIG The Adjusted Gross Income of the business
  • TotalIncome The total income filed
  • IRSBalance The balance owed by the business to the IRS
  • FileDate The date the IRS received the tax form from the business
  • LienDate If populated, the date a lien was issued to the business
  • LateDate If populated, the date after the deadline a tax form was received
  • LevyDate If populated, the date a levy was issued to the business
  • AuditDate If populated, the date an audite is planned for the business
  • IADate If populated, the date a payment plan was issued to the business
  • CNCDate If populated, the date a business was given Curently Not Collectable (CNC) status
  • OfferDate If populated, the date an offer from the IRS was issued to the business
  • AgencyDate If populated, the date
  • SFRDate If populated, the date a Substitue of return was filed by the IRS
  • PaymentDate If populated, the date when the business last made a payment
  • ExtensionDate If populated, the date the business was given an extension on the filing deadline
  • FTDPenaltyDate If populated, the date the business missed their Federal Tax Deposit

Example response body for the business method

Example of response when a business is not in the system.

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

Response Codes