Extend your software with TaxBandits IRS E-file API Integration

Skip to main content
Version: 1.7.1

Get

This method will return the Business information based on the given parameters. In Request JSON, using the Get method, supply the BusinessID or EIN or PayerRef.

The response will have the Business Information such as the BusinessName, Address, Contact details along with its status message. 

GET Business/Get

Request Body

FieldTypeDescription
BusinessIdstringUnique Identifier of the business.
TINstringTaxpayer Identification Number of business.
PayerRefstringOptional Unique identifier of the payer. Set by the client in the endpoint Business/RequestByUrl.

Response Body

FieldTypeDescription
StatusCodenumberReturns the status codes like 200,300 etc.
StatusNamestringName of the status code.
StatusMessagestringDetailed status message
Businessobject[]Business Details
    BusinessIdGuidUnique Identifier of the business.
    PayerRefstringUnique identifier of the payer. Set by the client.
    BusinessNmstringName of the business
    TradeNmstringOptional Name under which the business operates
    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)
    EmailstringOptional Email address of the Business
    ContactNmstringOptional Name of the person who can be contacted by the IRS
    PhonestringOptional Contact number of the business with area code
    PhoneExtnstringOptional Extension number of the business phone number
    FaxstringOptional Fax number of the Business
    BusinessTypestringType of business. Optional for W-2/1099 and mandatory for 94X series
    SigningAuthorityobjectDetails of the person who is authorized to sign the return.
        NamestringOptional Name of the signing authority.
        PhonestringOptional Phone number of the authorized signatory.
        BusinessMemberTypestringOptional Business title of the authorized signatory.
    KindOfEmployerstringIdentifies the kind of employer. Mandatory for W-2 and optional for 1099-MISC and 94X series
    KindOfPayerstringIdentifies the kind of payer. Mandatory for W-2 and optional for 1099-MISC and 94X series
    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)
        Address2stringOptional Suite or apartment number of the Employer/Payer.
        CitystringCity where the Employer/Payer is based out of
        StatestringName of the state where the Employer/Payer is based out of
        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)
        Address2stringOptional Suite or apartment number of the Employer/Payer.
        CitystringCity where the Employer/Payer is based out of
        ProvinceOrStateNmstringName of the province or state where the Employer/Payer is based out of.
        CountrystringCountry of the Employer/Payer.
        PostalCdstringPostal Code the State where the Employer/Payer is based out of
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: Get the Business data of an Employer/Payer using BusinessID along with TIN and PayerRef.

"Business/Get?BusinessId=7289099A-E20F-4271-AB29-06865CECCB03&TIN=12-3456767&PayerRef=B123"

Response JSON: The response will have the completed Business information for the given PayerRef corresponding to the BusinessId and TIN.

{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"Business": {
"BusinessId": "17e1efa1-37b8-4ace-89e9-877fe749b64e",
"PayerRef": "B123",
"BusinessNm": "Eastman Kodak Company",
"TradeNm": "Kodak",
"IsEIN": true,
"EINorSSN": "003313330",
"Email": "john@gmail.com",
"ContactNm": "John",
"Phone": "1234567890",
"PhoneExtn": "12345",
"Fax": "(123) 456-7890",
"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"
}
},
"Errors": null
}