Get

Get

This endpoint retrieves the complete details of a specific business — including name, TIN information, address, contact details, and any form-specific fields. Use this to verify business data or retrieve details for display in your application.

Identify the business using its BusinessId, PayerRef, or TIN. You can also filter by DBA using DBAId or DBARef.

You can provide any one of the following identifier combinations to retrieve the payer details:

• BusinessId only
• PayerRef only
• TINType with TIN
• TINType with Encrypted TIN
• TINType with TIN Token
• TINType with the last 4 digits of the TIN

GET business/get 

Run in Postman

Request Body

Field	Type	Description
BusinessId	GUID	Unique identifier of the business. Required if PayerRef is not provided
PayerRef	String	Optional Your unique identifier for the business. Required if BusinessId is not provided.
TINType	String	The TIN type of the business. Allowed values "EIN", "SSN", "QI-EIN", "ITIN", "WP-EIN", "WT-EIN", "NQI-EIN", "IRSN"
TIN	String	Taxpayer Identification Number of the business.
Last4Digit	String	Last 4 digits of the Taxpayer Identification Number of the business.
DBAId	GUID	TaxBandits-generated unique identifier of the DBA.
DBARef	string	Your unique identifier for a specific DBA to retrieve.

Response Body

Field	Type	Description
Business	Object	Array of matching business records.
SequenceId	String	A unique reference ID for the submission that can be used to identify a particular record.
PayerRef	String	Your unique identifier for the payer.
IsDefaultBusiness	Boolean	Identifies whether this is the default business.
TINDetails	Object	TIN details of the business.
Format	String	TIN format used for this business.
TINType	String	TIN type of the business.
TIN	String	Taxpayer identification number of the business.
IndividualNm	Object	If the TINType is SSN
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's name
BusinessNm	String	Name of the business.
NameCtrl	String	Name control of the business.
DBADetails	Object	DBA details of the business.
DBANm	String	Name of the DBA.
DBARef	String	Your unique identifier for the DBA.
DBAId	GUID	TaxBandits-generated unique identifier of the DBA.
Address	Object	Address details of the DBA
Address1	String	Street address or PO Box of the DBA.
Address2	String	Suite or apartment of the DBA.
City	String	City of the DBA.
ProvinceOrState	String	Province or state name of the DBA.
ZipCd	String	ZIP code of the DBA.
Country	String	Country code of the DBA.
Address	object	Address of the business
Address1	String	Street address or PO Box of the business.
Address2	String	Suite or apartment of the business.
City	String	City of the business.
ProvinceOrState	String	Province or state name of the business.
ZipCd	String	ZIP code of the business.
Country	String	Country code of the business.
ContactDetails	Object	Details of the person the IRS can contact regarding this business.
FirstNm	String	First name of the contact person.
MiddleNm	String	Middle name of the contact person.
LastNm	String	Last name of the contact person.
Suffix	String	The suffix of the contact person.
Phone	String	Phone number of the contact person
PhoneExtn	String	Phone extension number.
Email	String	Email address of the contact person.
Fax	String	Fax number of the contact person.
W2Specific	Object	Information specific to W-2 filings. Optional for 1099 and 94X.
KindOfEmployer	String	Identifies the kind of employer.
KindOfPayer	String	Identifies the kind of payer.
Form1042SSpecific	Object	Information specific to 1042-S filings
WHAgtCh3Cd	String	Chapter 3 status code of the Withholding Agent.
WHAgtCh4Cd	String	Chapter 4 status code of the Withholding Agent
WHAgtGIIN	String	Withholding agent's Global Intermediary Identification Number (GIIN).
FTIN	String	Foreign Tax Identification Number of the withholding agent.
Country	String	Withholding agent's country code.
ACASpecific	object	Optional Information specific to ACA filings
IsIssuer	Boolean	Confirms if the business is an insurer
IsGovernmentUnit	Boolean	Confirms if the business is a disregarded governmental entity
Form480Specific	object	Optional Information specific to 480 filings
TaxPayerType	String	Type of taxpayer
BusinessType	String	Legal structure of the business. Mandatory for 94X, optional for W-2 and 1099.
SigningAuthority	Object	Details of the person authorized to sign the return. Mandatory for 94X series.
FirstNm	String	First name of the signatory.
MiddleNm	String	Middle name of the signatory.
LastNm	String	Last name of the signatory.
Suffix	String	The suffix of the signatory.
Phone	String	Phone number of the signatory.
PhoneExtn	String	Phone extension number of the signatory.
BusinessMemberType	String	Title or role of the signatory.
Errors	object[]	Shows detailed error information
Id	string	Returns the validation error ID
Name	string	Name of the validation error
Message	string	Description of the validation error

Request Json

Sample	Description	Action
Sample 1	Get a business using business, payer, TIN type, TIN, and hashed TIN identifiers.

Sample 1

business/get?businessId=eb110a4f-21ed-421d-be74-c20fe16c86ef&PayerRef=Pe71690&TINType=EIN&TIN=12-0544484

Response Json

Sample	Description	Action
200	Success Response - This is a sample response for successful API requests.
400	Bad Request Response - You'll get the below response when your API requests contain any validation errors.

{
  "Business": {
      "BusinessId": "eb110a4f-21ed-421d-be74-c20fe16c86ef",
      "PayerRef": "Pe77162",
      "IsDefaultBusiness": false,
      "IsActive": true,
      "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "XX-XXX4484"
      },
      "IndividualNm": null,
      "BusinessNm": "O'Reilly Group",
      "NameCtrl": "SNOW",
      "DBADetails": [
          {
              "DBANm": "Iceberg Icecreams",
              "DBARef": "DBA1001",
              "DBAId": "ce1f01ce-e680-4768-abd0-7bcd75185430",
              "Address": {
                  "Address1": "123 Main St",
                  "Address2": "Suite 1001",
                  "City": "Rock Hill",
                  "ProvinceOrState": "AL",
                  "ZipCd": "35008",
                  "Country": "US"
              }
          }
      ],
      "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
      },
      "ContactDetails": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr",
          "Phone": "(803) 555-1234",
          "PhoneExtn": "101",
          "Email": "james@sample.com",
          "Fax": "(803) 555-5678"
      },
      "W2Specific": {
          "KindOfEmployer": "STATEORLOCAL501C",
          "KindOfPayer": "REGULAR941"
      },
      "Form1042SSpecific": {
          "WHAgtCh3Cd": "32",
          "WHAgtCh4Cd": "49",
          "WHAgtGIIN": "234324.42344.LE.372",
          "FTIN": "74FT736839",
          "Country": "AL"
      },
      "ACASpecific": {
          "IsInsurer": false,
          "IsGovernmentalUnit": true
      },
      "Form480Specific": {
          "TaxPayerType": "CORPORATION"
      },
      "BusinessType": "ESTE",
      "SigningAuthority": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr",
          "Phone": "(803) 555-1234",
          "PhoneExtn": "102",
          "BusinessMemberType": "ADMINISTRATOR"
      }
  },
  "Errors": null
}