List

List

This endpoint returns a paginated list of businesses created within a specified date range. Use this to audit your business records, check active/inactive status, or build a directory view within your application.

In the request JSON, you must provide the date range and the number of businesses you want to be listed on each page.

GET business/list 

Run in Postman

Request Body

Field	Type	Description
BusinessId	GUID	Unique identifier of the business. Required if PayerRef is not provided
PayerRef	String	Your unique identifier for the payer.
TIN	String	Taxpayer identification number of the business
TINType	String	TIN type of the business.
IsActive	Boolean	Optional When TRUE, only active businesses are returned in the response. When FALSE, only deactivated businesses are returned.
Last4Digit	String	Optional Filter by the last 4 digits of the business TIN
FromDate	String	Optional Return businesses created on or after this date. Format: MM/DD/YYYY
ToDate	String	Optional Return businesses created on or before this date. Format: MM/DD/YYYY
Page	int	Page number to retrieve. Starts at 1.
PageSize	int	Number of records per page. Maximum: 100

Response Body

Field	Type	Description
Businesses	Object[]	Array of matching business records.
BusinessId	GUID	TaxBandits-generated unique identifier of the business.
PayerRef	String	Your unique identifier for the business.
IsDefaultBusiness	Boolean	Identifies whether this is the default business.
IsActive	Boolean	Gets the active status of the 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.
Page	number	Requested page number.
TotalRecords	number	Total number of records returned in the response.
TotalPages	number	Number of pages with records.
PageSize	number	Requested page size.
Errors	object[]	Top-level request errors if the entire request cannot be processed
Id	string	Validation error code
Name	string	Name of the validation rule that failed
Message	string	Description of what went wrong

Payload

Request Params

Sample	Description	Action
Sample 1	List businesses using active status, TIN, date range, and pagination filters.

Sample 1

business/list?businessId=eb110a4f-21ed-421d-be74-c20fe16c86ef&IsActive=true&Last4Digit=4484&FromDate=04/20/2026&ToDate=04/21/2026&Page=62&PageSize=10&PayerRef=Pe67242

Response JSON

Response	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.

Response: 200

{
  "Businesses": [
    {
      "BusinessId": "eb110a4f-21ed-421d-be74-c20fe16c86ef",
      "PayerRef": "Pe77162",
      "IsDefaultBusiness": false,
      "IsActive": true,
      "TINDetails": {
        "TINType": "EIN",
        "Last4Digit": "4484",
        "TINMatchStatus": null
      },
      "IndividualNm": null,
      "BusinessNm": "O'Reilly Group",
      "NameCtrl": "SNOW",
      "DBADetails": {
        "DBANm": "Iceberg Icecreams",
        "DBARef": "DBA1001",
        "DBAId": "ce1f01ce-e680-4768-abd0-7bcd75185430"
      },
      "Email": "james@sample.com",
      "Address": {
        "Address1": "123 Main St",
        "Address2": "Suite 1001",
        "City": "Rock Hill",
        "ProvinceOrState": "SC",
        "ZipCd": "29730",
        "Country": "US"
      },
      "CreatedTime": "2026-07-07 09:07:29 -04:00",
      "LastUpdatedTime": "2026-07-07 09:07:29 -04:00"
    }
  ],
  "Page": 1,
  "PageSize": 100,
  "TotalRecords": 1,
  "TotalPages": 1,
  "Errors": null
}

Go Lang

package main

import (
    "fmt"
    "io"
    "net/http"
    "strings"
)

func main() {
    url := "<APIURL>/v2.0.0/business/list?businessId=eb110a4f-21ed-421d-be74-c20fe16c86ef&IsActive=true&Last4Digit=4484&FromDate=04%2F20%2F2026&ToDate=04%2F21%2F2026&Page=62&PageSize=10&PayerRef=Pe67242"
    method := "GET"

    payload := strings.NewReader(``)

    client := &http.Client{}

    req, err := http.NewRequest(method, url, payload)
    if err != nil {
        fmt.Println(err)
        return
    }

    req.Header.Add("Content-Type", "application/json")
    req.Header.Add("Authorization", "<ACCESS_TOKEN>")

    res, err := client.Do(req)
    if err != nil {
        fmt.Println(err)
        return
    }
    defer res.Body.Close()

    body, err := io.ReadAll(res.Body)
    if err != nil {
        fmt.Println(err)
        return
    }

    fmt.Println(string(body))
}

Node.js

  const axios = require('axios');
  let data = '';

  let config = {
    method: 'get',
    maxBodyLength: Infinity,
    url: '<APIURL>/v2.0.0/business/list?businessId=eb110a4f-21ed-421d-be74-c20fe16c86ef&IsActive=true&Last4Digit=4484&FromDate=04/20/2026&ToDate=04/21/2026&Page=62&PageSize=10&PayerRef=Pe67242',
    headers: { 
      'Content-Type': 'application/json', 
      'Authorization': '<ACCESS_TOKEN>'
    },
    data : data
  };

  axios.request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

Python

  import http.client
  import json

  conn = http.client.HTTPSConnection("<APIURL>")
  payload = ''
  headers = {
    'Content-Type': 'application/json',
    'Authorization': '<ACCESS_TOKEN>'
  }
  conn.request("GET", "/v2.0.0/business/list?businessId=eb110a4f-21ed-421d-be74-c20fe16c86ef&IsActive=true&Last4Digit=4484&FromDate=04/20/2026&ToDate=04/21/2026&Page=62&PageSize=10&PayerRef=Pe67242", payload, headers)
  res = conn.getresponse()
  data = res.read()
  print(data.decode("utf-8"))

.NET C#

  var client = new HttpClient();
  var request = new HttpRequestMessage(HttpMethod.Get, "<APIURL>/v2.0.0/business/list?businessId=eb110a4f-21ed-421d-be74-c20fe16c86ef&IsActive=true&Last4Digit=4484&FromDate=04/20/2026&ToDate=04/21/2026&Page=62&PageSize=10&PayerRef=Pe67242");
  request.Headers.Add("Authorization", "<ACCESS_TOKEN>");
  var content = new StringContent("", null, "application/json");
  request.Content = content;
  var response = await client.SendAsync(request);
  response.EnsureSuccessStatusCode();
  Console.WriteLine(await response.Content.ReadAsStringAsync());

Ruby

  require "uri"
  require "json"
  require "net/http"

  url = URI("<APIURL>/v2.0.0/business/list?businessId=eb110a4f-21ed-421d-be74-c20fe16c86ef&IsActive=true&Last4Digit=4484&FromDate=04/20/2026&ToDate=04/21/2026&Page=62&PageSize=10&PayerRef=Pe67242")

  http = Net::HTTP.new(url.host, url.port);
  request = Net::HTTP::Get.new(url)
  request["Content-Type"] = "application/json"
  request["Authorization"] = "<ACCESS_TOKEN>"

  response = http.request(request)
  puts response.read_body

Java

  OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
  MediaType mediaType = MediaType.parse("application/json");
  RequestBody body = RequestBody.create(mediaType, "");
  Request request = new Request.Builder()
    .url("<APIURL>/v2.0.0/business/list?businessId=eb110a4f-21ed-421d-be74-c20fe16c86ef&IsActive=true&Last4Digit=4484&FromDate=04/20/2026&ToDate=04/21/2026&Page=62&PageSize=10&PayerRef=Pe67242")
    .method("GET", body)
    .addHeader("Content-Type", "application/json")
    .addHeader("Authorization", "<ACCESS_TOKEN>")
    .build();
  Response response = client.newCall(request).execute();

cURL

  curl --location '<APIURL>/v2.0.0/business/list?businessId=eb110a4f-21ed-421d-be74-c20fe16c86ef&IsActive=true&Last4Digit=4484&FromDate=04%2F20%2F2026&ToDate=04%2F21%2F2026&Page=62&PageSize=10&PayerRef=Pe67242'   --header 'Content-Type: application/json'   --header 'Authorization: <ACCESS_TOKEN>'   --data ''