List businesses

{
  "success": true,
  "message": "Businesses retrieved successfully",
  "traceId": "0HNNKQIN7BJO2:00000024",
  "data": {
    "data": [
      {
        "businessUuid": "019fed1a-3d6e-75d3-a81e-cba3874b0a55",
        "legalName": "Rose Gardens LLC",
        "businessStatus": "Draft",
        "parentReference": "8cfec329267",
        "createdAt": "2026-08-10T19:15:47.694655",
        "lastUpdated": "2026-08-10T19:15:47.694655",
        "_links": {
          "self": "/v2/businesses/019fed1a-3d6e-75d3-a81e-cba3874b0a55"
        }
      }
    ],
    "pagination": {
      "page": 1,
      "totalPages": 1,
      "totalRecords": 1,
      "pageSize": 1,
      "hasNext": false,
      "hasPrevious": false
    }
  }
}

Lists businesses with optional filtering and pagination.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

statusstringOptional

Filter by business status.

namestringOptional

Filter by legal name.

merchantCatCodestringOptional

Filter by merchant category code.

legalStructurestringOptional

Filter by legal structure.

limitintegerOptional

Number of results per page.

pageintegerOptional

Page number to return.

sortBystringOptional

Field to sort by.

sortOrderstringOptional

Sort direction.

Response

A page of businesses.

successboolean

Whether the request succeeded.

messagestring or null

A human-readable result message.

traceIdstring or null

The trace identifier for the request, useful for support.

dataobject or null

The page of businesses.

warningslist of objects or null

Non-blocking warnings.

Errors

401

Unauthorized Error

500

Internal Server Error