The BUSINESS method returns a summary, by tax period, of all relevent data that creates a tax profile of the business. Such things as
Total Sales, AGI, the forms filed, filing date, if a balance is owed, and any actions the IRS has taken or are planning on taking.
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
{
"EIN": "XX-XXX5555",
"Data": [
{
"Period": 201512,
"Form": "1120",
"FormType": "ACTR",
"UpdateDate": "10/18/2021",
"AnnualForm": "1120",
"TotalIncome": 494412.00,
"TotalSales": 573674.00,
"TotalCompensation": 25500.00,
"IRSBalance": 29206.07,
"FileDate": "11/07/2016",
"LienDate": "09/27/2019",
"LateDate": "11/12/2018",
"LevyDate": "08/10/2020",
"NoticeDate": "01/09/2020",
"PaymentDate": "04/09/2021",
"ExtensionDate": "04/04/2016"
}]
}
Example of response when a business is not in the system.
{"taxpayer":"Waiting on IRS"}
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. |