Get a business

Beta

GET

/v2/businesses/:businessReference

GET

/api/v2/businesses/:businessReference

curl https://api-sandbox.payabli.com/api/v2/businesses/019fed1a-3d6e-75d3-a81e-cba3874b0a55 \
     -H "Authorization: Bearer <token>"

{
  "success": true,
  "message": "Business retrieved successfully",
  "traceId": "0HNNKQIN7BJO3:00000008",
  "data": {
    "businessUuid": "019fed1a-3d6e-75d3-a81e-cba3874b0a55",
    "legalName": "Rose Gardens LLC",
    "legalStructure": "LimitedLiabilityCompany",
    "incorporationState": "GA",
    "taxIdCountry": "US",
    "taxExemptClassification": null,
    "license": "LIC-48213",
    "licenseState": "GA",
    "taxReference": "****8993",
    "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"
    },
    "externalId": "rg-001",
    "website": "https://example.com",
    "merchantCatCode": "5814",
    "phone": [
      "3055551212"
    ],
    "emails": [
      "ops@example.com"
    ],
    "addressDetails": [],
    "paymentMethods": [
      {
        "type": "bank_account",
        "name": "Operating account",
        "financialInstitution": "Bank of Example",
        "ownerType": "business",
        "accountType": "checking",
        "accountNumber": "****6789",
        "routingNumber": "****0021",
        "usage": [
          "deposits",
          "billing"
        ],
        "isDefault": true
      },
      {
        "type": "bank_account",
        "name": "Payout account",
        "financialInstitution": "Bank of Example",
        "ownerType": "business",
        "accountType": "checking",
        "accountNumber": "****4321",
        "routingNumber": "****0021",
        "usage": [
          "payOutFunding"
        ],
        "isDefault": false
      }
    ],
    "isTaxExempt": false,
    "certificationDetails": []
  }
}

Retrieves a business by reference. Sensitive fields such as taxReference are masked.

Authentication

AuthorizationBearer

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

Path parameters

businessReferencestringRequired

The business reference (businessUuid).

Response

The business.

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 business detail.

warningslist of objects or null

Non-blocking warnings.

Errors

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error