---
title: "Segment live member ids (keyset)"
method: GET
path: "/api/v1/ackdb/observe/segments/{id}/member-ids"
tags: ["ackDB"]
---

# Segment live member ids (keyset)

`GET /api/v1/ackdb/observe/segments/{id}/member-ids`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/ackdb/observe/segments/{id}/member-ids`
- Auth: HTTP bearer

Segment Sync S1: keyset-paginated full list of a segment's CURRENT members (the live filter, not the snapshot) - used to seed a delivery ledger and to reconcile an invalid cursor. The member id is the company `entity_id` (company segment) or the `contact_id` (contact segment). Derived segments compose with their base (base membership pivoted into the render grain AND the derived filter). Each page echoes `filterHash`; a hash change between pages means the population shifted mid-seed - restart. Page with `after = nextCursor` until `hasMore` is false. A cross-grain `?grain=` request → 400. Any query parameter other than `after`, `limit`, `grain` → 400 UNKNOWN_QUERY_PARAM (a pager sending `?cursor=` would otherwise get page 1 forever).

## Path parameters

- `id` string, required

## Query parameters

- `after` string
- `limit` integer

## Response `200`

A keyset page of member ids.

- AckdbMemberIdsResponse
  - `segmentId` string, required
  - `entityIds` string[], required: Member ids (company entity_id or contact_id), ascending.
  - `nextCursor` string, nullable, required: Pass as ?after= for the next page; null when the set is exhausted.
  - `hasMore` boolean, required
  - `filterHash` string, nullable: The membership's version hash (same value /changes carries). A multi-page seed that sees it change between pages straddles two populations and should restart. Null when edit detection is degraded.
  - `limit` integer, required: The effective page size (the request's `limit` after clamping to [1, 5000]; default 1000).

## Other responses

- `400`: Cross-grain `?grain=` request, an unknown query parameter, or a stale filter.
- `404`: No segment with that id.

---

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