FLfloqer
ackDB

The person timeline (cross-company)

Every event stamped with this human, newest first, INTERLEAVED across every company they have ever been affiliated with — the query that answers "have we talked to Elly?" once instead of N times. Backed by the partial (person_id, timestamp DESC) index. Source events appear as <source>_<event_type> (emails_message.sent); ackDB's own lifecycle events are BARE (contact.created, contact.ended, historical person.merged, new person.identity.merged) with source: system. Independent personal events have null company/contact IDs and remain on the human even after an affiliation is added. Includes independent personal events. Filters apply before pagination; personal ownership with entityId is invalid.

get/api/v1/ackdb/persons/{personId}/events

Request

  • Base URL
    http://localhost:3009
  • Auth
    HTTP bearer

Path parameters

personIdstring required

Person id (ULID = persons.person_id). A merged (tombstoned) id resolves to its survivor.

Query parameters

limitinteger
offsetinteger
sourcestring
sourcesstring

CSV include list — only these sources. Mutually exclusive with source/excludeSources (400).

excludeSourcesstring

CSV exclude list — drop these sources (e.g. ackDB bookkeeping events). Mutually exclusive with source/sources (400).

eventTypestring
sincestring date-time
untilstring date-time
ownership'person' | 'company'

person selects sole-person events; company selects company-associated events; omit for both. Filters before pagination/counts. Personal ownership conflicts with entityId/company graph.

entityIdstring

Company filter before pagination/counts.

Response

{ data: EntityEvent[], total, limit, offset, personId }.

totalinteger required
limitinteger required
offsetinteger required
personIdstring required

Example response

{
  "data": [
    {
      "id": "01HXYZ123456789ABCDEFGH",
      "source": "slack",
      "eventType": "message",
      "summary": "Customer asked about pricing in #acme-corp"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.