Get

Use this endpoint to obtain the details of a created business, such as the name, address, and contact details. In the request JSON, you must provide either the BusinessId or PayerRef.

GET Business/Get 

Request Params

Field	Type	Description
BusinessId	string	Unique Identifier of the business.
TIN	string	Taxpayer Identification Number of business.
PayerRef	string	Optional Unique identifier of the payer. Set by the client in the endpoint Business/RequestByUrl.

Request Params

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=Pe126145

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
Business	object	Business Details
BusinessId	Guid	Unique Identifier of the business.
PayerRef	string	Unique identifier of the payer. Set by the client.
BusinessNm	string	Name of the business
FirstNm	string	First Name of the Individual
MiddleNm	string	Middle Name of the Individual
LastNm	string	Last Name of the Individual
Suffix	string	Suffix of the Individual Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
TradeNm	string	Optional Name under which the business operates
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)
Email	string	Optional Email address of the Business
ContactNm	string	Optional Name of the person who can be contacted by the IRS
Phone	string	Optional Contact number of the business with area code
PhoneExtn	string	Optional Extension number of the business phone number
Fax	string	Optional Fax number of the Business
BusinessType	string	Type of business. Optional for W-2/1099 and mandatory for 94X series
SigningAuthority	object	Details of the person who is authorized to sign the return.
Name	string	Optional Name of the signing authority.
Phone	string	Optional Phone number of the authorized signatory.
BusinessMemberType	string	Optional Business title of the authorized signatory.
KindOfEmployer	string	Identifies the kind of employer. Mandatory for W-2 and optional for 1099-MISC and 94X series
KindOfPayer	string	Identifies the kind of payer. Mandatory for W-2 and optional for 1099-MISC and 94X series
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: ..46
Address2	string	Optional Suite or apartment number of the Employer/Payer. Size Range: ..46
City	string	City where the Employer/Payer is based out of Size Range: ..50
State	string	Name of the state where the Employer/Payer is based out of Size Range: ..2
ZipCd	string	Zip Code the State where the Employer/Payer is based out of. Size Range: 5..10
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: ..50
Address2	string	Optional Suite or apartment number of the Employer/Payer. Size Range: ..50
City	string	City where the Employer/Payer is based out of Size Range: ..50
ProvinceOrStateNm	string	Name of the province or state where the Employer/Payer is based out of Size Range: ..50
Country	string	Country of the Employer/Payer Size Range: ..2
PostalCd	string	Postal Code the State where the Employer/Payer is based out of Size Range: ..16
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.

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": "69b9461c-c107-41d4-9582-1ef544a4a961",
        "PayerRef": "Snow123",
        "BusinessNm": null,
        "FirstNm": "James",
        "MiddleNm": null,
        "LastNm": "Smith",
        "Suffix": null,
        "TradeNm": "Iceberg Icecreams",
        "IsEIN": false,
        "EINorSSN": "XXX-XX-0999",
        "Email": "james@sample.com",
        "ContactNm": "James Smith",
        "Phone": "8708620033",
        "PhoneExtn": "91",
        "Fax": "(345) 455-3465",
        "BusinessType": "PART",
        "SigningAuthority": {
            "Name": "James Smith",
            "Phone": "(986) 532-1550",
            "BusinessMemberType": "MANAGINGMEMBER"
        },
        "KindOfEmployer": "NONGOVT501C",
        "KindOfPayer": "RAILROADFORMCT1",
        "IsBusinessTerminated": false,
        "Form1042SDetails": {
            "WHAgtCh3Cd": null,
            "WHAgtCh4Cd": null,
            "WHAgtGIIN": null,
            "FTIN": null,
            "Country": "US"
        },
        "IsForeign": false,
        "USAddress": {
            "Address1": "3576 AIRPORT WAY",
            "Address2": "UNIT 9",
            "City": "FAIRBANKS",
            "State": "AK",
            "ZipCd": "99709"
        },
        "ForeignAddress": {
            "Address1": null,
            "Address2": null,
            "City": null,
            "ProvinceOrStateNm": null,
            "Country": null,
            "PostalCd": null
        },
        "ACADetails": null
    },
    "Errors": null
}