Skip to main content
Migrating from v1.7.3 to v2.0 View the migration guide for a full breakdown of what's changed and how to update your integration. View Migration Guide
Version: 2.0

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 business details directly in the CREATE request for the corresponding tax form, rather than adding the business as a separate step.

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.
  • TIN Format — TaxBandits supports PLAIN formats, giving you flexibility in how sensitive tax identification numbers are passed through your system.
  • 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.
  • Deactivate - Temporarily deactivate a business without deleting it. Filings cannot be made against a deactivated business, but all associated recipient data remains intact.
  • Reactivate - Reactivate a previously deactivated business. All recipient data and configuration carry over — filings can resume immediately.

DBA (Doing Business As) Endpoints​

If a business operates under a trade name different from its IRS-registered name, DBAs can be added and managed separately. Once a DBA is added, the business can request W-9s, send transactions, and distribute 1099s under that DBA name.

  • AddDBA - Add one or more DBA names to an existing business. Each DBA gets a unique DBAId.
  • UpdateDBA - Update the name or address of an existing DBA.
  • ListDBA - Retrieve all DBA names associated with a specific business.
  • DeleteDBA - Remove a specific DBA from a business.