Skip to main content
Version: 1.7.0

Update

After the business is created and requires any update, use the Update method to change the current business information by supplying Business Id.

For the description of ENUM values, Click Here.

PUT Business/Update 
Run in Postman

Request Body

FieldTypeDescription
    BusinessIdobjectUnique Identifier of the business
    BusinessNmstringName of the business
Size Range: ..75
    PayerRefStringOptionalAn 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-11
    EmailstringOptional Email address of the Business
Size Range: ..100
    ContactNmstringOptional Name of the person who can be contacted by the IRS
Size Range: ..27
    PhonestringContact 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"

For the description of the Allowed Values , click here
    SigningAuthorityobjectDetails of the person who is authorized to sign the return.
        NamestringOptional Name of the signing authority.
Size Range: ..35
        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.
Size Range: 5..10
    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

"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

Request JSON

Update the existing business details using BusinessID.

{
"BusinessId": "c71a0eab-93a3-4df4-b67d-c2f33a9851c3",
"BusinessNm": "ABC LLC",
"PayerRef": "Pe126145",
"TradeNm": "Kodak",
"IsEIN": true,
"EINorSSN": "003313332",
"Email": "sample@bodeem.com",
"ContactNm": "John",
"Phone": "1234567890",
"PhoneExtn": "12345",
"Fax": "1234567890",
"BusinessType": "ESTE",
"SigningAuthority": {
"Name": "John",
"Phone": "1234567890",
"BusinessMemberType": "ADMINISTRATOR"
},
"KindOfEmployer": "FederalGovt",
"KindOfPayer": "Regular941",
"IsBusinessTerminated": true,
"IsForeign": false,
"USAddress": {
"Address1": "1751 Kinsey Rd",
"Address2": "Main St",
"City": "Dothan",
"State": "AL",
"ZipCd": "36303"
},
"ForeignAddress": {
"Address1": null,
"Address2": null,
"City": null,
"ProvinceOrStateNm": null,
"Country": null,
"PostalCd": null
}
}

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.

Response JSON

Response will switch the existing business details with the new one.

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