Get Company

Get Company

Use this endpoint to retrieve the full company profile — legal name, EIN, entity type, contact details, office locations, and bank accounts — for the employer identified by entity_ids.

The company details are read-only. No IDs from this response are needed for other endpoints.

GET organization/company 

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
entity_ids	string	The organization ID. Must be exactly one UUID.

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 company profile.
id	string	Company UUID.
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?entity_ids=519a84f4-5e56-496a-82f3-18f51fdf3d75
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 entity_ids is missing or invalid.
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": "23-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"
      }
    ]
  }
}