---
title: "Query ingest logs"
method: GET
path: "/api/v1/ackdb/ingest/logs"
tags: ["ackDB"]
---

# Query ingest logs

`GET /api/v1/ackdb/ingest/logs`

## Request

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

Returns paginated ingest logs with optional filters. Each log captures one ingest HTTP request's full lifecycle: validation timing, entity resolution path, write counts, and error details.

## Query parameters

- `entityId` string
- `source` string
- `status` 'success' | 'deduplicated' | 'unresolved' | 'error'
- `since` string, date-time
- `until` string, date-time
- `limit` integer
- `offset` integer

## Response `200`

Paginated ingest logs

- object
  - `data` AckdbIngestLog[]
    - `id` string: ULID
    - `endpoint` string: '/ingest' or '/ingest/batch'
    - `source` string
    - `status` 'success' | 'deduplicated' | 'unresolved' | 'error'
    - `entityId` string, nullable
    - `entityCreated` boolean
    - `resolutionPath` 'domain_match' | 'source_id_match' | 'universal_id_match' | 'domain_create' | 'anchor_match' | 'anchor_create' | 'explicit' | 'unresolved', nullable
    - `idempotencyKey` string, nullable
    - `requestSizeBytes` integer, nullable
    - `contentId` string, nullable: raw_payload ID
    - `eventId` string, nullable: entity_event ID
    - `identityLinksCreated` integer
    - `traitsWritten` integer
    - `contactsProcessed` integer
    - `filesProcessed` integer
    - `deduplicated` boolean
    - `itemCount` integer, nullable: Batch only: total items in request
    - `acceptedCount` integer, nullable: Batch only: items accepted
    - `duplicatedCount` integer, nullable: Batch only: items deduplicated
    - `errorCode` string, nullable
    - `errorMessage` string, nullable
    - `durationMs` integer: Total request duration in milliseconds
    - `timingDetail` object, nullable: Phase breakdown
      - `validation_ms` integer
      - `resolution_ms` integer
      - `writes_ms` integer
    - `createdAt` string, date-time
  - `pagination` AckdbPagination
    - `total` integer
    - `limit` integer
    - `offset` integer

---

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