---
title: "List activity logs"
method: GET
path: "/v1/logs"
tags: ["Logs"]
---

# List activity logs

`GET /v1/logs`

Unified logs endpoint. Returns logs for publishing, connections, webhooks, and messaging.
Filter by type, platform, status, and time range. Logs are retained for 90 days.

## Query parameters

- `type` 'all' | 'publishing' | 'connections' | 'webhooks' | 'messaging' | 'workflow_event' | 'api_request'
- `status` 'success' | 'failed' | 'pending' | 'skipped' | 'all'
- `platform` 'tiktok' | 'instagram' | 'whatsapp' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'all'
- `action` string
- `search` string
- `days` integer
- `limit` integer
- `skip` integer
- `account_id` string
- `event` string
- `request_id` string
- `from` string, date-time
- `to` string, date-time
- `status_code` integer
- `api_key_id` string
- `include_read_receipts` boolean

## Response `200`

Logs retrieved successfully

- object
  - `logs` object[]
    - `type` string — Log category (publishing, connections, webhooks, messaging)
    - `action` string — Specific action (post.published, message.sent, account.connected, etc.)
    - `user_id` string
    - `platform` string
    - `account_id` string
    - `status` 'success' | 'failed' | 'pending' | 'skipped'
    - `status_code` integer
    - `error_message` string
    - `error_code` string
    - `duration_ms` integer
    - `endpoint` string — The API endpoint that triggered this log
    - `request_body` string — Request JSON (truncated to 5KB)
    - `response_body` string — Response JSON (truncated to 10KB)
    - `created_at` string, date-time
    - `metadata` string — Additional context as JSON string
    - `request_id` string — Correlation ID linking every log from one API request (api_request logs)
    - `api_key_id` string — The API key that made the request (api_request logs)
    - `method` string — HTTP method (api_request logs)
    - `path` string — Request path (api_request logs)
    - `ip_address` string — Client IP address (api_request logs)
    - `user_agent` string — Client user-agent (api_request logs)
  - `pagination` object
    - `total` integer
    - `limit` integer
    - `skip` integer
    - `pages` integer
    - `hasMore` boolean

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/f81ca70ea6b9/schema)