The EMPLOYMENT method returns a summary of an individual's employment history, including any Schedule-C companies and beneficiary of a trust or estate (K1) information.
This will be employer information and the tax years applicable. .
Response Body
application/json
The following is a list of all possible fields.
Attributes
-
TIN
The last 4 digits of the SSN sent in the request.
-
FullName
The full name of the individual sent in the request
-
EmploymentHistory
An array of objects for each W2 employer
-
EmploymentType
Type of IRS form and income the data is from. The following types are possible:
- Regular_(W2) - Taxpayer is an employee of this company
- Contract_(1099-MISC,1099-NEC) - Taxpayer is a contractor of this company
- Self-Employed_(ScheduleC) - Taxpayer is owner this company
- Owner-Partner_(ScheduleK1-1065) - Taxpayer shares n ownership of this company
- Owner-Corporate_(ScheduleK1-1120) - Taxpayer receives distributions from this company
-
TaxYears
The year range the employee has worked for this company. if there are breaks in the range the oon-consecutive years
will be comma separtated, i.e. 2015-2019, 2021
-
EmployerEIN
The EIN of the employer (if available)
-
Employer
The full name of the employer
-
EmployerAddress
the address of the employer
-
OwnershipShare
If applicable, the share percentage of wonership
Example response bodys for the employment method
{
"TIN": "XXX-XX-2222",
"FullName": "SAMMY SMITH",
"EmploymentHistory": [{
"EmploymentType": "Regular_(W-2)",
"TaxYears": "2015 - 2022",
"EmployerEIN": "",
"Employer": "HALL PRIVATE WEALTH ADVISORS LLC 3887",
"EmployerAddress": "991C LOMAS SANTA FE DR SOLANA BEACH, CA 92075-0000"
}, {
"EmploymentType": "Owner-Partner_(ScheduleK1-1065)",
"TaxYears": "2013 - 2022",
"EmployerEIN": "XX_XXX7196",
"Employer": "MAARGEL PARTNERS LLC",
"EmployerAddress": "NECTAVE 6700 CABALLERO BLVD",
"OwnershipShare": "95%"
}, {
"EmploymentType": "Owner-Partner_(ScheduleK1-1065)",
"TaxYears": "2016 - 2022",
"EmployerEIN": "XX_XXX5669",
"Employer": "TOPLINE CAPITAL III RL LLC",
"EmployerAddress": "17853 SANTIAGO BLVD STE 107 350 VILLA PARK, C",
"OwnershipShare": "100%"
}, {
"EmploymentType": "Owner-Corporate_(ScheduleK1-1120)",
"TaxYears": "2016 - 2021",
"EmployerEIN": "XX_XXX3392",
"Employer": "D AND L PARTNERS LLC",
"EmployerAddress": "7268 MOUNTAIN ASH DR SE GRAND RAPIDS, MI 4954",
"OwnershipShare": "10%"
}, {
"EmploymentType": "Self-Employed_(ScheduleC)",
"TaxYears": "2019 - 2021",
"EmployerEIN": "XX-XXX3887",
"Employer": "HAL PRIV WEAL",
"EmployerAddress": "991-C"
}, {
"EmploymentType": "Owner-Partner_(ScheduleK1-1065)",
"TaxYears": "2013 - 2021",
"EmployerEIN": "XX_XXX2810",
"Employer": "MORGAN STANLEY CAPITAL PARTNERS VEMPLOY",
"EmployerAddress": "INVESTORS LP 440 S LASALLE STREET 39TH FLOOR",
"OwnershipShare": "95%"
}, {
"EmploymentType": "Contract_(1099-MISC,1099-NEC)",
"TaxYears": "2015 - 2019",
"EmployerEIN": "",
"Employer": "M S HOWELLS AND CO 8422",
"EmployerAddress": "2055 N PIMA RD SUITE 10 SCOTTSDALE, AZ 85255-7154"
}, {
"EmploymentType": "Regular_(W-2)",
"TaxYears": "2013 - 2017",
"EmployerEIN": "",
"Employer": "MORGAN STANLEY AND CO LLC 5998",
"EmployerAddress": "1 NEW YORK PLAZA 5TH NEW YORK, NY 10004-0000"
}, {
"EmploymentType": "Contract_(1099-MISC,1099-NEC)",
"TaxYears": "2015",
"EmployerEIN": "",
"Employer": "JOHN HANCOCK LIFE INS. CO. U.S.A. 3346",
"EmployerAddress": "US AGENCY COMPENSATION P O BOX 600"
}, {
"EmploymentType": "Owner-Corporate_(ScheduleK1-1120)",
"TaxYears": "2013",
"EmployerEIN": "XX_XXX0282",
"Employer": "BIZINTRO INC",
"EmployerAddress": "BIZINTRO INC 4653 CARMEL MOUNTAIN ROAD 308 40",
"OwnershipShare": "15%"
}]
}
{
"TIN": "XXX-XX-3333",
"FullName": "LINDA JONES",
"EmploymentHistory": [{
"EmploymentType": "Self-Employed_(ScheduleC)",
"TaxYears": "2017 - 2020",
"EmployerEIN": "XX-XXX0079",
"Employer": "SHEM COUT LL",
"EmployerAddress": "976 E"
}, {
"EmploymentType": "Regular_(W-2)",
"TaxYears": "2018 - 2020",
"EmployerEIN": "",
"Employer": "TEXAS CHRISTIAN UNIVERSITY 7465",
"EmployerAddress": "TCU BOX 298200 FORT WORTH, TX 76129-0000"
}, {
"EmploymentType": "Regular_(W-2)",
"TaxYears": "2013 - 2020",
"EmployerEIN": "",
"Employer": "TSC SURGICAL GROUP PLLC 4830",
"EmployerAddress": "221 W COLORADO PAVIL DALLAS, TX 75208-0000"
}, {
"EmploymentType": "Contract_(1099-MISC,1099-NEC)",
"TaxYears": "2016 - 2017",
"EmployerEIN": "",
"Employer": "METHODIST HOSPITALS OF DALLAS 0661",
"EmployerAddress": "PO BOX 227116 DALLAS, TX 75222-7116"
}, {
"EmploymentType": "Contract_(1099-MISC,1099-NEC)",
"TaxYears": "2013",
"EmployerEIN": "",
"Employer": "TEXAS TECH UNIVERSITY SYSTEMS 2622",
"EmployerAddress": "BOX 41091 LUBBOCK, TX 79409-1091"
}]
}
Example response when taxpayer is not in the system.
{"message":"Taxpayer not found."}
The possible reponse codes are below.
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. |