---
title: "List a segment's member shares"
method: GET
path: "/api/v1/ackdb/observe/segments/{id}/shares"
tags: ["ackDB"]
---

# List a segment's member shares

`GET /api/v1/ackdb/observe/segments/{id}/shares`

## Request

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

Returns the members a segment is shared with — memberId + name + email + role (#284). Visible to anyone who can see the segment; 403 otherwise.

## Path parameters

- `id` string, required

## Response `200`

The segment's grants, oldest first.

- object
  - `data` AckdbSegmentShare[], required
    - `memberId` string, required
    - `role` 'view' | 'edit', required
    - `name` string, required
    - `email` string, required
    - `createdAt` string, date-time

## Other responses

- `403`: Caller cannot see the segment (#284).
- `404`: Segment not found.

---

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