Query Logs

Retrieve logs from Timberlogs with filtering and pagination.

List Logs


GET /v1/logs

Query Parameters

Parameter	Type	Default	Description
`limit`	number	100	Number of logs to return (max 1000)
`offset`	number	0	Number of logs to skip
`level`	string	-	Filter by log level
`source`	string	-	Filter by source
`environment`	string	-	Filter by environment
`dataset`	string	-	Filter by dataset
`userId`	string	-	Filter by user ID
`sessionId`	string	-	Filter by session ID
`flowId`	string	-	Filter by flow ID
`from`	number	-	Start timestamp (Unix ms)
`to`	number	-	End timestamp (Unix ms)

Response


{
  "logs": [
    {
      "id": "log_abc123",
      "timestamp": 1704067200000,
      "level": "info",
      "message": "User signed in",
      "source": "api-server",
      "environment": "production",
      "userId": "user_123",
      "sessionId": "sess_abc",
      "data": {"method": "oauth"},
      "tags": ["auth"]
    }
  ],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "count": 50,
    "hasMore": false
  }
}

Examples

Basic query:


curl -X GET "https://timberlogs-ingest.enaboapps.workers.dev/v1/logs" \
  -H "Authorization: Bearer tb_live_xxxxxxxxxxxxx"

Filter by level:


curl -X GET "https://timberlogs-ingest.enaboapps.workers.dev/v1/logs?level=error" \
  -H "Authorization: Bearer tb_live_xxxxxxxxxxxxx"

Filter by source and environment:


curl -X GET "https://timberlogs-ingest.enaboapps.workers.dev/v1/logs?source=api-server&environment=production" \
  -H "Authorization: Bearer tb_live_xxxxxxxxxxxxx"

Filter by time range:


curl -X GET "https://timberlogs-ingest.enaboapps.workers.dev/v1/logs?from=1704067200000&to=1704153600000" \
  -H "Authorization: Bearer tb_live_xxxxxxxxxxxxx"

Filter by user:


curl -X GET "https://timberlogs-ingest.enaboapps.workers.dev/v1/logs?userId=user_123" \
  -H "Authorization: Bearer tb_live_xxxxxxxxxxxxx"

Filter by flow:


curl -X GET "https://timberlogs-ingest.enaboapps.workers.dev/v1/logs?flowId=checkout-a1b2c3d4" \
  -H "Authorization: Bearer tb_live_xxxxxxxxxxxxx"

Pagination:


# First page
curl -X GET "https://timberlogs-ingest.enaboapps.workers.dev/v1/logs?limit=50" \
  -H "Authorization: Bearer tb_live_xxxxxxxxxxxxx"
 
# Second page
curl -X GET "https://timberlogs-ingest.enaboapps.workers.dev/v1/logs?limit=50&offset=50" \
  -H "Authorization: Bearer tb_live_xxxxxxxxxxxxx"

Get Single Log


GET /v1/logs/:id

Retrieve a single log by its ID.

Response


{
  "log": {
    "id": "log_abc123",
    "timestamp": 1704067200000,
    "level": "info",
    "message": "User signed in",
    "source": "api-server",
    "environment": "production",
    "userId": "user_123",
    "sessionId": "sess_abc",
    "requestId": "req_xyz",
    "data": {"method": "oauth"},
    "tags": ["auth"],
    "flowId": "login-x1y2z3",
    "stepIndex": 0
  }
}

Error Response

404 Not Found:


{
  "error": "Log not found"
}

Example


curl -X GET "https://timberlogs-ingest.enaboapps.workers.dev/v1/logs/log_abc123" \
  -H "Authorization: Bearer tb_live_xxxxxxxxxxxxx"

Log Object

Field	Type	Description
`id`	string	Unique log identifier
`timestamp`	number	Unix timestamp in milliseconds
`level`	string	Log level: `debug`, `info`, `warn`, `error`
`message`	string	Log message
`source`	string	Application/service name
`environment`	string	Environment name
`dataset`	string	Dataset name
`version`	string	Application version
`userId`	string	User identifier
`sessionId`	string	Session identifier
`requestId`	string	Request identifier
`data`	object	Additional structured data
`errorName`	string	Error class/name
`errorStack`	string	Error stack trace
`tags`	string[]	Array of tags
`country`	string	Country code (auto-detected)
`ipAddress`	string	Client IP address
`flowId`	string	Flow identifier
`stepIndex`	number	Step index within flow

Pagination

The API uses offset-based pagination:

limit - Number of items per page (default: 100, max: 1000)
offset - Number of items to skip
hasMore - Boolean indicating if more results exist

To iterate through all logs:


let offset = 0
const limit = 100
let hasMore = true
 
while (hasMore) {
  const response = await fetch(
    `https://timberlogs-ingest.enaboapps.workers.dev/v1/logs?limit=${limit}&offset=${offset}`,
    { headers: { Authorization: `Bearer ${apiKey}` } }
  )
  const data = await response.json()
 
  // Process data.logs
  console.log(`Fetched ${data.logs.length} logs`)
 
  hasMore = data.pagination.hasMore
  offset += limit
}