Skip to main content
Version: 1.7.0

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

FieldTypeDescription
    BusinessNmstringName of the business.
Size Range: ..75
    PayerRefStringOptional 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
    TradeNmstringOptional Name under which the business operates
Size Range: ..75
    IsEINBooleanWhen true, identifies the business with an EIN.
    EINorSSNstringWhen IsEIN is true, use Employer Identification Number (EIN). When IsEIN is false, use Social Security Number (SSN)
Size Range: 9
    EmailstringOptional Email address of the Business
Size Range: ..40
    ContactNmstringOptional Name of the person who can be contacted by the IRS
Size Range: ..27
    PhonestringOptional Contact number of the business with area code
Size Range: 10
    PhoneExtnstringOptional Extension number of the business phone number
Size Range: ..5
    FaxstringOptional Fax number of the Business
Size Range: 10
    BusinessTypestringType of business. Optional for W-2/1099 and mandatory for 94X series
Size Range: ..4
Allowed values: "ESTE", "PART", "CORP", "EORG", "SPRO"
    SigningAuthorityobjectDetails of the person who is authorized to sign the return.
        NamestringOptional Name of the signing authority.
Size Range: ..75
        PhonestringOptional Phone number of the authorized signatory.
Size Range: 10
        BusinessMemberTypestringOptional 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"
    KindOfEmployerstringIdentifies the kind of employer. Mandatory for W-2 and optional for 1099-MISC and 94X series
Allowed values: "FEDERALGOVT", "STATEORLOCAL501C", "NONGOVT501C", "STATEORLOCALNON501C", "NONEAPPLY"
    KindOfPayerstringIdentifies 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"
    IsBusinessTerminatedBooleanWhen true, identifies the business as terminated.
    IsForeignBooleanWhen true, identifies the business address with a foreign address.
    USAddressobjectif IsForeign is false, pass US address of the business
        Address1stringAddress of the Employer/Payer (street address or post office box of that locality)
Size Range: ..35
        Address2stringOptional Suite or apartment number of the Employer/Payer.
Size Range: ..35
        CitystringCity where the Employer/Payer is based out of
Size Range: ..27
        StatestringName 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"
        ZipCdstringZip Code the State where the Employer/Payer is based out of
    ForeignAddressobjectif IsForeign is true, pass foreign address of the business.
        Address1stringAddress of the Employer/Payer (street address or post office box of that locality)
Size Range: ..35
        Address2stringOptional Suite or apartment number of the Employer/Payer.
Size Range: ..35
        CitystringCity where the Employer/Payer is based out of
Size Range: ..27
        ProvinceOrStateNmstringName of the province or state where the Employer/Payer is based out of.
Size Range: ..30
        CountrystringCountry 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"
        PostalCdstringPostal Code the State where the Employer/Payer is based out of

Response Body

FieldTypeDescription
StatusCodenumberReturns the status codes like 200, 300 etc.
StatusNamestringName of the status code.
StatusMessagestringDetailed status message
BusinessIdGuidUnique Identifier of the business
PayerRefstringUnique identifier of the payer.
IsEINBooleanWhen true, identifies the business with an EIN.
EINorSSNstringEmployer Identification Number (EIN) or Social Security Number (SSN)
BusinessNmstringName of the business
Errorsobject[]Shows detailed error information.
    CodestringReturns the validation error code.
    NamestringName of the validation error.
    MessagestringDescription of the validation error.
    TypestringType 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}

Your IRS-Authorized E-filing Experts for
Form 1099, W-2, W-9, 1095, 94x, & more