---
title: "Business Profile — the self-configuring layer for Recommendation Survival: the business's model (local_service / product / online_service / b2b_saas / marketplace / content_creator), category, locality, offerings, and the buyer decision-axes each offering narrows on. Auto-detects once (cached) when none exists — deterministic-first with a one-time governed LLM-assist. Read first to run the right recommendation-survival journey for any business."
method: GET
path: "/entities/{entityId}/business-profile"
tags: ["Layer 1 — Profile"]
---

# Business Profile — the self-configuring layer for Recommendation Survival: the business's model (local_service / product / online_service / b2b_saas / marketplace / content_creator), category, locality, offerings, and the buyer decision-axes each offering narrows on. Auto-detects once (cached) when none exists — deterministic-first with a one-time governed LLM-assist. Read first to run the right recommendation-survival journey for any business.

`GET /entities/{entityId}/business-profile`

## Request

- Base URL: `https://entidex.com/api/v1`
- URL: `https://entidex.com/api/v1/entities/{entityId}/business-profile`
- Auth: HTTP bearer

## Path parameters

- `entityId` string, required

## Response `200`

The derived/declared business profile, or { available: false }.

- union
  - BusinessProfile: The self-configuring profile that makes Recommendation Survival adapt to any business: its model, category, locality, offerings, and buyer decision-axes. Auto-detected once (cached) with a governed LLM-assist, or declared (declared fields win).
    - `entityId` string, required
    - `available` true, required
    - `model` 'local_service' | 'product' | 'online_service' | 'b2b_saas' | 'marketplace' | 'content_creator' | 'other', required
    - `category` string, required
    - `locality` string, nullable, required
    - `offerings` BusinessProfileOffering[], required
      - `id` string, required
      - `name` string, required
      - `useCase` string, nullable, required: The job a buyer solves with this offering.
      - `decisionAxes` BusinessProfileAxis[], required
        - `label` string, required
        - `fragment` string, required: The plain buyer phrasing appended to narrow the search (never an internal key).
    - `source` 'detected' | 'declared' | 'hybrid', required
    - `confidence` number, required
    - `provenance` object, required
      - `detectedFrom` string[], required
      - `llmAssisted` boolean, required
      - `note` string, required
    - `version` string, required
    - `derivedAt` string, date-time, required
  - BusinessProfileUnavailable
    - `entityId` string, required
    - `available` false, required
    - `reason` 'disabled' | 'no_profile_yet', required

## Other responses

- `404`: Entity or resource not found.

---

[API](https://skmtc.dev/entidex/apis/entidex-api.md) · [All operations](https://skmtc.dev/entidex/apis/entidex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/entidex/apis/entidex-api/revisions/86b92f21a09a?raw)