Skip to main content
The Business endpoint is now available in API v2.0 with an improved structure, enhanced security, and new capabilities including bulk creation, TIN tokenization, and full DBA management. View V2.0 Documentation
Version: 1.7.3

Overview

The Business endpoints allow you to add, update, and manage the businesses (payers or employers) for which you are filing tax forms in TaxBandits.

When filing tax forms through the TaxBandits API, we recommend creating the business first before collecting W-9s or filing any tax forms on their behalf. Having the business set up in advance keeps your integration clean and avoids repeating business details across every form request.

You can also include the business details directly in the CREATE request of the relevant tax form, instead of adding the business separately.

Key elements​

  • BusinessId — A unique GUID generated by TaxBandits on business creation. Use this as your primary business reference across all endpoints.
  • PayerRef — An optional identifier you define for the business. Can be used interchangeably with BusinessId in most endpoints.
  • IsDefaultBusiness — Flag a business as the default so it is automatically used when no specific business is referenced in a request.

Business Endpoints:​

You can use the following endpoints to manage businesses in TaxBandits API.

To use the following endpoints, you must first call the Auth method to obtain an access token. Include this token in your request header as a Bearer token. Refer to OAuth 2.0 Authentication.

  • Create - Create a new business in TaxBandits. Returns a unique BusinessId that can be used in all subsequent requests — no need to pass full business details every time.
  • Update - Update the details of an existing business. Changes apply to returns that are in progress; they do not affect returns already transmitted.
  • Get - Retrieve the full details of a specific business using its BusinessId or PayerRef.
  • List - Get a paginated list of businesses created within a specified date range. Supports filtering by active status, TIN, and more.
  • Delete - Delete a business permanently. A business cannot be deleted if tax forms are already associated with it, unless IsForceDelete is set to true.
  • RequestByUrl - Generate a request URL and send it to the payer or employer, allowing them to enter their own business details directly into TaxBandits. Useful when you want the client to own their data entry.