Skip to main content
GET
/
businesses
/
{businessID}
Get Business by ID
curl --request GET \
  --url https://api.example.com/businesses/{businessID} \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "message": "Business details retrieved successfully.",
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "Acme Corporation",
    "tin": "**-***6789",
    "mobile": "+15550109999",
    "official_website": "https://www.acme.com",
    "public_website": "https://acme.com",
    "social_account": "@acmecorp",
    "address_apartment": "Suite 400",
    "address_line_1": "123 Main St",
    "address_line_2": "Floor 4",
    "address_city": "New York",
    "address_state": "NY",
    "address_postal_code": "10001",
    "address_country": "US",
    "created_at": "2024-01-01T08:00:00Z",
    "created_by": "user_123",
    "updated_at": "2024-03-12T10:30:00Z",
    "updated_by": "user_456",
    "status": "VERIFIED",
    "industry": {
      "id": "ind_99",
      "name": "Hospitality",
      "code": "HOSP",
      "sector_code": "72",
      "created_at": "2024-01-01T08:00:00Z",
      "updated_at": "2024-03-12T10:30:00Z"
    },
    "mcc_id": "mcc_01",
    "naics_id": "naics_01",
    "is_deleted": false,
    "naics_code": "722511",
    "naics_title": "Full-Service Restaurants",
    "mcc_code": "5812",
    "mcc_title": "Eating Places and Restaurants",
    "external_id": "EXT-98765",
    "customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "is_monitoring_enabled": true,
    "deleted_by": null,
    "deleted_at": null,
    "subscription": {
      "status": "ACTIVE",
      "created_at": "2024-01-01T08:00:00Z",
      "updated_at": "2024-03-12T10:30:00Z"
    },
    "owners": [
      {
        "id": "owner_789",
        "title": {
          "id": "title_01",
          "title": "Owner"
        },
        "first_name": "John",
        "last_name": "Doe",
        "ssn": "***-**-1234",
        "email": "john.doe@example.com",
        "mobile": "+15550101111",
        "date_of_birth": "1980-01-01",
        "apartment": "Apt 2B",
        "line_1": "456 Owner Rd",
        "line_2": null,
        "city": "Brooklyn",
        "state": "NY",
        "postal_code": "11201",
        "country": "US",
        "created_at": "2024-01-01T08:00:00Z",
        "created_by": "user_123",
        "updated_at": "2024-03-12T10:30:00Z",
        "updated_by": "user_456",
        "ownership_percentage": 51,
        "owner_type": "CONTROL"
      }
    ],
    "business_names": [
      {
        "name": "Acme Corp",
        "is_primary": true
      }
    ],
    "business_addresses": [
      {
        "line_1": "123 Main St",
        "apartment": "Suite 400",
        "city": "New York",
        "state": "NY",
        "country": "US",
        "postal_code": "10001",
        "mobile": "+15550109999",
        "is_primary": true
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

businessID
string<uuid>
required

The unique identifier (UUID) representing the specific business to retrieve.

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Query Parameters

fetch_owner_details
boolean
default:false

A flag indicating whether to include the detailed owner information in the response payload. Defaults to false.

Response

Business details retrieved successfully.

Standard response wrapping the business details data.

status
string

The operational status of the request (e.g., 'success', 'fail').

Example:

"success"

message
string

A human-readable message describing the result of the operation.

Example:

"Business details retrieved successfully."

data
BusinessDetails · object

Comprehensive schema detailing a business's profile, including compliance, location, and structural data.