Employment Method POST

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


Request Path

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


/Employment Request application/json

This method uses the Tax Identification Number (TIN) for an individual, which is their SSN, to retrieve all relevant employment and beneficiary information.

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 (SSN - no spaces or hypens) of the individual taxpayer

Example call request body for the employment method

{ "companyId":"enco45100", "tin":"222222222" }

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.