List activity 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.

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Query Parameters

type?string

Log category to query. Use all for the unified view across every category, or api_request for your API request logs (method, path, status, latency).

Default"publishing"

status?string

Filter by status

Value in"success" | "failed" | "pending" | "skipped" | "all"

platform?string

Filter by platform

Value in

"tiktok" | "instagram" | "whatsapp" | "facebook" | "youtube" | "linkedin" | "twitter" | "threads" | "pinterest" | "reddit" | "bluesky" | "googlebusiness" | "telegram" | "snapchat" | "all"

action?string

Filter by action (e.g., post.published, message.sent, account.connected, webhook.delivered)

search?string

Free-text search across log fields

days?integer

Number of days to look back (max 90)

Default90

Range1 <= value <= 90

limit?integer

Maximum number of logs to return (max 100)

Default50

Range1 <= value <= 100

skip?integer

Number of logs to skip (for pagination)

Default0

Range0 <= value

account_id?string

Filter by connected account ID

event?string

Filter webhook logs by event (e.g. post.published, message.received)

request_id?string

Correlation ID — returns every log spawned by a single API request

from?string

Precise start instant (ISO 8601); narrows within the day range

Formatdate-time

to?string

Precise end instant (ISO 8601)

Formatdate-time

status_code?integer

Filter by exact HTTP status code (api_request logs)

api_key_id?string

Filter by the API key that made the request (api_request logs)

include_read_receipts?boolean

Include message.read / message.delivered events (hidden by default for messaging logs)

Defaultfalse

Response Body

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.logs.listLogs();console.log(data);

{
  "logs": [
    {
      "type": "string",
      "action": "string",
      "user_id": "string",
      "platform": "string",
      "account_id": "string",
      "status": "success",
      "status_code": 0,
      "error_message": "string",
      "error_code": "string",
      "duration_ms": 0,
      "endpoint": "string",
      "request_body": "string",
      "response_body": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "metadata": "string",
      "request_id": "string",
      "api_key_id": "string",
      "method": "string",
      "path": "string",
      "ip_address": "string",
      "user_agent": "string"
    }
  ],
  "pagination": {
    "total": 0,
    "limit": 0,
    "skip": 0,
    "pages": 0,
    "hasMore": true
  }
}

{
  "error": "Unauthorized"
}

List activity 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.

Authorization

AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Query Parameters

type?string

Log category to query. Use all for the unified view across every category, or api_request for your API request logs (method, path, status, latency).

Default"publishing"

status?string

Filter by status

Value in"success" | "failed" | "pending" | "skipped" | "all"

platform?string

Filter by platform

Value in

"tiktok" | "instagram" | "whatsapp" | "facebook" | "youtube" | "linkedin" | "twitter" | "threads" | "pinterest" | "reddit" | "bluesky" | "googlebusiness" | "telegram" | "snapchat" | "all"

action?string

Filter by action (e.g., post.published, message.sent, account.connected, webhook.delivered)

search?string

Free-text search across log fields

days?integer

Number of days to look back (max 90)

Default90

Range1 <= value <= 90

limit?integer

Maximum number of logs to return (max 100)

Default50

Range1 <= value <= 100

skip?integer

Number of logs to skip (for pagination)

Default0

Range0 <= value

account_id?string

Filter by connected account ID

event?string

Filter webhook logs by event (e.g. post.published, message.received)

request_id?string

Correlation ID — returns every log spawned by a single API request

from?string

Precise start instant (ISO 8601); narrows within the day range

Formatdate-time

to?string

Precise end instant (ISO 8601)

Formatdate-time

status_code?integer

Filter by exact HTTP status code (api_request logs)

api_key_id?string

Filter by the API key that made the request (api_request logs)

include_read_receipts?boolean

Include message.read / message.delivered events (hidden by default for messaging logs)

Defaultfalse

Response Body

application/json

import Zernio from '@zernio/node';

const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });

const { data } = await zernio.logs.listLogs();
console.log(data);

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.logs.listLogs();console.log(data);

{
  "logs": [
    {
      "type": "string",
      "action": "string",
      "user_id": "string",
      "platform": "string",
      "account_id": "string",
      "status": "success",
      "status_code": 0,
      "error_message": "string",
      "error_code": "string",
      "duration_ms": 0,
      "endpoint": "string",
      "request_body": "string",
      "response_body": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "metadata": "string",
      "request_id": "string",
      "api_key_id": "string",
      "method": "string",
      "path": "string",
      "ip_address": "string",
      "user_agent": "string"
    }
  ],
  "pagination": {
    "total": 0,
    "limit": 0,
    "skip": 0,
    "pages": 0,
    "hasMore": true
  }
}

{
  "error": "Unauthorized"
}

List activity logs

Authorization

Query Parameters

Response Body

200application/json

401application/json

List activity logs

Authorization

Query Parameters

Response Body

200application/json

401application/json

application/json

application/json

application/json

application/json