FLfloqer
ackDB

List a company's people

One row per affiliation edge, each carrying the personId of the human behind it — the company-side mirror of GET /persons/{personId}/contacts.

status picks which affiliations count (#430):

  • active (default) — people who work there now. This is what "who works at Acme" means, and it is what /profile, /full and the AI agent read.
  • former — ended affiliations only, each stamped with endedAt.
  • any — both, current people first (then newest lastSeenAt). Use this to show departures alongside current staff — the champion who left in March is often the whole story.

any never includes disabled edges: that status is the soft delete behind DELETE /entities/{entityId}/contacts/{contactId}, so a removed contact stays removed.

get/api/v1/ackdb/entities/{entityId}/contacts

Request

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

Path parameters

entityIdstring required

Company id.

Query parameters

status'active' | 'former' | 'any'

Which affiliations to return. Anything else is a 400.

is_externalboolean

true = customer-side contacts only; false = internal staff only. Omit for both.

Response

{ data: Contact[] } — each with personId, status, and endedAt when former.

dataunknown required

Changes

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