---
title: "Get aggregated entity profile"
method: GET
path: "/api/v1/ackdb/entities/{entityId}/profile"
tags: ["ackDB"]
---

# Get aggregated entity profile

`GET /api/v1/ackdb/entities/{entityId}/profile`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/ackdb/entities/{entityId}/profile`
- Auth: HTTP bearer

Returns a complete entity profile - the entity, its identity links, all traits, and recent events in a single response. This is the primary endpoint for AI agents (L1 query tier). Designed for fast, single-call retrieval of everything known about an entity.

## Path parameters

- `entityId` string, required

## Response `200`

Aggregated entity profile

- object
  - `data` AckdbEntityProfile, required: Aggregated entity profile - everything known about an entity in a single object. This is the primary response format for AI agent queries (L1 tier).
    - `entity` AckdbEntity, required: A company/account entity in ackDB's entity store.
      - `entityId` string, required: Internal ULID identifier for the entity.
      - `name` string, required: Human-readable entity name (e.g. company name). May be null for auto-created entities.
      - `createdAt` string, date-time, required: When the entity was first created.
      - `updatedAt` string, date-time, required: When the entity was last updated.
    - `identityLinks` AckdbIdentityLink[], required: All identity links for this entity.
      - `entityId` string, required: The entity this link belongs to.
      - `source` string, required: Source system (e.g. slack, stripe).
      - `externalIdType` string, required: Type of external ID (e.g. slack_channel_id).
      - `externalIdValue` string, required: The actual external ID value.
      - `confidence` number, required: Confidence score of the link (0-1). 1.0 = verified.
      - `linkedAt` string, date-time, required: When this identity link was created.
    - `traits` AckdbEntityTrait[], required: All computed traits for this entity.
      - `entityId` string, required: The entity this trait belongs to.
      - `traitKey` string, required: Trait identifier (matches a trait_definition).
      - `valueString` unknown, required
      - `valueNumber` unknown, required
      - `valueBool` unknown, required
      - `valueDate` string, date-time, required: Date value (populated for date traits).
      - `source` string, required: Source system that produced this trait.
      - `workflow` string, required: Workflow that computed this value.
      - `confidence` number, required: Confidence score (0-1). 1.0 = observed/verified.
      - `updatedAt` string, date-time, required: When this trait value was last updated.
    - `recentEvents` AckdbEntityEvent[], required: Recent activity events (default: last 20).
      - `id` string, required: ULID identifier for the event.
      - `entityId` unknown, required
      - `source` string, required: Source system that produced this event.
      - `eventType` string, required: Type of event (e.g. message, payment, subscription_change).
      - `summary` string, required: Human-readable summary of the event.
      - `metadata` object, required: Source-specific event metadata.
      - `timestamp` string, date-time, required: When this event occurred in the source system.
      - `createdAt` string, date-time, required: When this event record was created in ackDB.
      - `contactId` unknown, required
      - `personId` unknown, required

## Other responses

- `404`: Entity not found

---

[API](https://skmtc.dev/floqer/apis/floqer-public-api.md) - [All operations](https://skmtc.dev/floqer/apis/floqer-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/floqer/apis/floqer-public-api/revisions/fce50dc07b20?raw)