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

# List ackDB Syncs

`GET /api/v1/ackdb/syncs`

## Request

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

List the organization's durable ackDB segment-to-Floq syncs, newest first. This stored-state list does not call ackDB for a live segment count; use Get Sync for that detail. A key restricted by `allowed_workflow_ids` sees only permitted destinations.

## Response `200`

Default Response

- object
  - `status` integer, required
  - `data` AckdbSync[], required
    - `synced` boolean, required
    - `sync_id` unknown, required
    - `name` unknown, required
    - `segment_id` string, required
    - `entity_kind` unknown, required
    - `state` unknown, required
    - `segment_size` unknown, required
    - `segment_size_is_lower_bound` boolean, required
    - `last_import_error` object, required
      - `code` unknown, required
      - `message` string, required
    - `pending_confirmation` object, required
      - `held_count` integer, required
      - `reason` unknown, required
    - `created_by` unknown, required
    - `created_at` string, date-time, required
    - `connection_count` integer, required
    - `connections` AckdbSyncConnection[], required
      - `connection_id` string, required: Durable sync-connection id.
      - `workflow_id` string, uuid, required: Destination Floq workflow.
      - `status` 'active' | 'paused', required
      - `delivery_mode` 'current_state' | 'event_ledger_v1', required: Whether the workflow stores current membership or one immutable row per segment event.
      - `reentry_mode` 'suppress' | 'repush', required: Whether a member re-entering the segment is delivered again.
      - `push_existing` boolean, required: Whether members present at connection creation were seeded for delivery.
      - `run` 'all' | 'none', required: Whether delivered event rows execute the workflow or only insert rows.
      - `field_mapping` object, required: Workflow input reference to ackDB segment field mapping.
      - `mapping_warnings` string[], required: Stored mappings that could not be represented as current public workflow input references.
      - `created_at` string, date-time, required
      - `counters` AckdbSyncCounters, required
        - `delivered` integer, required: Rows delivered to the workflow, all time.
        - `exited_since_delivery` integer, required: Delivered rows whose member has since exited the segment.
        - `suppressed_reentries` integer, required: Re-entries suppressed by the connection's re-entry policy.
        - `held` integer, required: Rows held by a pause or breaker.
        - `pending` integer, required: Rows awaiting delivery.
        - `added` integer, required: Added events delivered by an event-ledger sync.
        - `removed` integer, required: Removed events delivered by an event-ledger sync.

## Other responses

- `401`: Default Response
- `403`: Default Response
- `429`: Default Response

---

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