---
title: "List persons"
method: GET
path: "/api/v1/ackdb/persons"
tags: ["ackDB"]
---

# List persons

`GET /api/v1/ackdb/persons`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/ackdb/persons`
- Auth: HTTP bearer

Paginated person list. Each row carries `affiliationCount` (contact edges), `keyCount` (durable keys) and `isInternal` (any edge with is_external=false), so a list view needs no follow-up calls. Tombstoned (merged) persons are hidden unless `status=merged`.

## Query parameters

- `q` string
- `status` 'active' | 'merged'
- `keyType` string
- `internal` boolean
- `affiliated` boolean
- `limit` integer
- `offset` integer

## Response `200`

`{ data: PersonListItem[], total, limit, offset }`.

- object
  - `data` unknown, required

---

[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)