Get Company by TIN

Get Company by TIN

Use this endpoint to look up a company by its Tax Identification Number (TIN / EIN) without needing the organization ID. This is useful when you have the EIN from an external source and need to resolve it to a company record.

This endpoint does not require the entity_ids query parameter. Authentication via Bearer token is still required.

GET organization/company/by-tin 

Header Parameters

Field	Type	Description
Authorization	string	Required. Bearer token obtained from the Auth endpoint. Format: Bearer <access_token>.
X-TaxBandits-Version	string	API version string. Use 1.0.0.

Query Parameters

Field	Type	Description
tin	string	Required. The Tax Identification Number to look up. Accepted formats: 9 digits (123456789) or hyphenated (12-3456789).

Response Body

Field	Type	Description
status	string	SUCCESS or FAILURE.
status_code	number	HTTP-style status code (e.g. 200, 400).
message	string	Human-readable status message.
response	object	The matched company record.
id	string	Company UUID (organization ID).
legal_name	string	Legal name of the company.
entity	object	Entity type information.
label	string	Human-readable entity label (e.g. Limited Liability Company).
type	string	Entity type code (e.g. llc, s_corporation).
ein	string	Employer Identification Number.
primary_email	string	Primary contact email. null if not set.
primary_phone_number	string	Primary contact phone number. null if not set.
locations	object[]	Office locations for the company.
line1	string	Address line 1.
line2	string	Address line 2. null if not set.
city	string	City.
state	string	State code (e.g. TX).
postal_code	string	ZIP code.
country	string	Always US.
accounts	object[]	Bank accounts on file.
routing_number	string	Bank routing number.
account_name	string	Account holder name.
institution_name	string	Bank name.
account_type	string	checking or savings.
account_number	string	Bank account number.

Payload

Request

GET organization/company/by-tin?tin=12-3456789
Header: X-TaxBandits-Version: 1.0.0

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 tin is missing or in an invalid format.
404	Not Found Response - You'll get the below response when no company matches the provided TIN.
401	Unauthorized Response - You'll get the below response when the Bearer token is missing or invalid.

{
  "status": "SUCCESS",
  "status_code": 200,
  "message": "Request processed successfully",
  "response": {
    "id": "519a84f4-5e56-496a-82f3-18f51fdf3d75",
    "legal_name": "Snowdaze LLC",
    "entity": {
      "label": "Limited Liability Company",
      "type": "llc"
    },
    "ein": "12-3456789",
    "primary_email": "info@snowdaze.com",
    "primary_phone_number": "512-555-0100",
    "locations": [
      {
        "line1": "100 Congress Ave",
        "line2": null,
        "city": "Austin",
        "state": "TX",
        "postal_code": "78701",
        "country": "US"
      }
    ],
    "accounts": [
      {
        "routing_number": "021000021",
        "account_name": "Snowdaze LLC",
        "institution_name": "Chase Bank",
        "account_type": "checking",
        "account_number": "000123456789"
      }
    ]
  }
}