Create

Use this endpoint to add a Business or Payer in TaxBandits. The same Business/Payer can be later used in 1099, W-2, ACA, 94x and W-9 endpoints. The PayerRef or BusinessId will act as the unique reference identifier.

POST Business/Create

Request Body

Field	Type	Description
BusinessNm	string	Name of the business. Size Range: ..75
PayerRef	String	Optional An unique identifier for each payer completing their information. This identifier can be used in future references of the payer in the API. Size Range: 1-50
TradeNm	string	Optional Name under which the business operates Size Range: ..75
IsEIN	Boolean	When true, identifies the business with an EIN.
EINorSSN	string	When IsEIN is true, use Employer Identification Number (EIN). When IsEIN is false, use Social Security Number (SSN) Size Range: 9
Email	string	Optional Email address of the Business Size Range: ..40
ContactNm	string	Optional Name of the person who can be contacted by the IRS Size Range: ..27
Phone	string	Optional Contact number of the business with area code Size Range: 10
PhoneExtn	string	Optional Extension number of the business phone number Size Range: ..5
Fax	string	Optional Fax number of the Business Size Range: 10
BusinessType	string	Type of business. Optional for W-2/1099 and mandatory for 94X series Size Range: ..4 Allowed values: "ESTE", "PART", "CORP", "EORG", "SPRO"
SigningAuthority	object	Details of the person who is authorized to sign the return.
Name	string	Optional Name of the signing authority. Size Range: ..75
Phone	string	Optional Phone number of the authorized signatory. Size Range: 10
BusinessMemberType	string	Optional Business title of the authorized signatory. Size Range: 5..29 Allowed values: "CORPORATESECRETARY", "SECRETARYTREASURER", "PARTNER", "GENERALPARTNER", "LIMITEDPARTNER", "LLCMEMBER", "MANAGINGMEMBER", "MANAGER", "TAXMATTERPARTNER", "PRESIDENT", "VICEPRESIDENT", "CORPORATETREASURER", "TREASURER", "ASSISTANTTREASURER", "CHIEFACCOUNTINGOFFICER", "CHIEFEXECUTIVEOFFICER", "CHIEFFINANCIALOFFICER", "TAXOFFICER", "CHIEFOPERATINGOFFICER", "CORPORATEOFFICER", "EXECUTIVEDIRECTOR", "DIRECTOR", "CHAIRMAN", "EXECUTIVEADMINISTRATOR", "RECEIVER", "PASTOR", "ASSISTANTTORELIGIOUSLEADER", "REVEREND", "PRIEST", "MINISTER", "RABBI", "LEADEROFRELIGIOUSORGANIZATION", "SECRETARY", "DIRECTOROFTAXATION", "DIRECTOROFPERSONNEL", "ADMINISTRATOR", "EXECUTOR", "TRUSTEE", "FIDUCIARY", "OWNER", "SOLEPROPRIETOR", "MEMBER", "SOLEMEMBER"
KindOfEmployer	string	Identifies the kind of employer. Mandatory for W-2 and optional for 1099-MISC and 94X series Allowed values: "FEDERALGOVT", "STATEORLOCAL501C", "NONGOVT501C", "STATEORLOCALNON501C", "NONEAPPLY"
KindOfPayer	string	Identifies the kind of payer. Mandatory for W-2 and optional for 1099-MISC and 94X series Allowed values: "REGULAR941", "REGULAR944", "AGRICULTURAL943", "HOUSEHOLD", "MILITARY", "MEDICAREQUALGOVEM", "RAILROADFORMCT1"
IsBusinessTerminated	Boolean	When true, identifies the business as terminated.
IsForeign	Boolean	When true, identifies the business address with a foreign address.
USAddress	object	if IsForeign is false, pass US address of the business
Address1	string	Address of the Employer/Payer (street address or post office box of that locality) Size Range: ..35
Address2	string	Optional Suite or apartment number of the Employer/Payer. Size Range: ..35
City	string	City where the Employer/Payer is based out of Size Range: ..27
State	string	Name of the state where the Employer/Payer is based out of Size Range: 2 Allowed values: "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP"
ZipCd	string	Zip Code the State where the Employer/Payer is based out of
ForeignAddress	object	if IsForeign is true, pass foreign address of the business.
Address1	string	Address of the Employer/Payer (street address or post office box of that locality) Size Range: ..35
Address2	string	Optional Suite or apartment number of the Employer/Payer. Size Range: ..35
City	string	City where the Employer/Payer is based out of Size Range: ..27
ProvinceOrStateNm	string	Name of the province or state where the Employer/Payer is based out of. Size Range: ..30
Country	string	Country of the Employer/Payer. Size Range: 2 Allowed values: "US", "CA", "MX", "AF", "AX", "XI", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "XA", "AT", "AS", "AU", "AJ", "XZ", "BF", "BA", "FQ", "BG", "BB", "BS", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "XY", "CV", "CJ", "CT", "CD", "XC", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "VP", "CS", "IV", "HR", "CU", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "UK", "EK", "ER", "EN", "ET", "EU", "FK", "FO", "FM", "FJ", "FI", "FR", "FG", "FP", "FS", "GB", "GA", "GZ", "GG", "GM", "GH", "GI", "GO", "GR", "GL", "GJ", "GP", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "JU", "KZ", "KE", "KQ", "KR", "KN", "KS", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MB", "MR", "MP", "MF", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "XM", "WA", "NR", "BQ", "NP", "NL", "NT", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "XN", "CQ", "NO", "MU", "OC", "PK", "LQ", "PS", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RE", "RO", "RS", "RW", "WS", "SM", "TP", "SA", "XS", "SG", "RI", "SE", "SL", "SN", "XR", "LO", "SI", "BP", "SO", "SF", "SX", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "XT", "TE", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UY", "UZ", "NH", "VT", "VE", "VM", "VQ", "WQ", "XW", "WF", "WE", "WI", "YM", "YI", "ZA", "ZI"
PostalCd	string	Postal Code the State where the Employer/Payer is based out of

Response Body

Field	Type	Description
StatusCode	number	Returns the status codes like 200, 300 etc.
StatusName	string	Name of the status code.
StatusMessage	string	Detailed status message
BusinessId	Guid	Unique Identifier of the business
PayerRef	string	Unique identifier of the payer.
IsEIN	Boolean	When true, identifies the business with an EIN.
EINorSSN	string	Employer Identification Number (EIN) or Social Security Number (SSN)
BusinessNm	string	Name of the business
Errors	object[]	Shows detailed error information.
Code	string	Returns the validation error code.
Name	string	Name of the validation error.
Message	string	Description of the validation error.
Type	string	Type of validation error.

Request JSON

{
   "BusinessNm": "Eastman Kodak Company",
   "PayerRef": "Pe126145",
   "TradeNm": "Kodak",
   "IsEIN": true,
   "EINorSSN": "003313330",
   "Email": "john@gmail.com",
   "ContactNm": "John",
   "Phone": "1234567890",
   "PhoneExtn": "12345",
   "Fax": "1234567890",
   "BusinessType": "ESTE",
   "SigningAuthority": {
       "Name": "John",
       "Phone": "1234567890",
       "BusinessMemberType": "ADMINISTRATOR"
   },
   "KindOfEmployer": "FEDERALGOVT",
   "KindOfPayer": "REGULAR941",
   "IsBusinessTerminated": false,
   "IsForeign": true,
   "USAddress": {
       "Address1": null,
       "Address2": null,
       "City": null,
       "State": null,
       "ZipCd": null
   },
   "ForeignAddress": {
       "Address1": "22 St",
       "Address2": "Clair Ave E",
       "City": "Toronto",
       "ProvinceOrStateNm": "Ontario",
       "Country": "CA",
       "PostalCd": "M1R 0E9"
   }
}

Response JSON

{
 "StatusCode": 200,
 "StatusName": "Ok",
 "StatusMessage": "Successful API call",
 "BusinessId": "17e1efa1-37b8-4ace-89e9-877fe749b64e",
 "PayerRef": "Pe126145",
 "IsEIN": true,
 "EINorSSN": "00-3313330",
 "BusinessNm": "Eastman Kodak Company",
 "Errors": null
}