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

# List segments

`GET /api/v1/ackdb/observe/segments`

## Request

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

Returns the saved Segments the caller can see (soft-deleted excluded), most-recently-updated first. ACL-filtered to ones they own, are shared on, plus every legacy (owner-less) and org-default row; each carries the caller's effective `access` (#284). A service/static-key call sees all.

## Query parameters

- `entityKind` 'company' | 'contact' | 'person'
- `limit` integer
- `offset` integer

## Response `200`

List of segment summaries.

- object
  - `data` AckdbSegmentSummary[], required
    - `id` string, required
    - `name` string, required
    - `description` string
    - `entityKind` 'company' | 'contact' | 'person', required
    - `isDefault` boolean, required: True when this Segment is the default view for its entity_kind.
    - `baseSegmentId` unknown, required
    - `ownerEmail` string, required: The segment's owner (JWT email), or null for a legacy/service-created row (#284).
    - `access` 'owner' | 'edit' | 'view', required: The caller's effective role on this row (#284) — drives client action gating.
    - `folderId` string, required: The folder THIS CALLER has filed this segment in, or null for 'Unfiled' (#470). Folders are personal: the same segment is filed differently (or not at all) for every other user, and a service/static-key call always reads null.
    - `folderPosition` unknown, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `pagination` AckdbPaginationMeta, required: Pagination metadata included in paginated responses.
    - `total` integer, required: Total number of records matching the query.
    - `limit` integer, required: Maximum number of records returned in this response.
    - `offset` integer, required: Number of records skipped.
    - `totalIsLowerBound` boolean: When true, `total` is a lower bound rather than an exact count. The Observe company query returns this when the count query was rejected or timed out and the result count was clamped (e.g. total=1000, totalIsLowerBound=true).

---

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