Skip to main content

​
GET /v1/events

List events with optional filters.

​
Query parameters

ParameterTypeDescription
agent_idstringFilter by agent ID
action_typestringFilter by action type
sincestringStart time (ISO 8601)
untilstringEnd time (ISO 8601)
label.{key}stringFilter by label value (e.g., label.env=prod)
limitintegerMax results (default: 100, max: 1000)
offsetintegerPagination offset

​
Example

# List recent events
curl http://localhost:7600/v1/events?limit=20

# Filter by agent
curl http://localhost:7600/v1/events?agent_id=my-agent

# Filter by label
curl "http://localhost:7600/v1/events?label.env=prod&limit=10"

​
Response

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "agent_id": "my-agent",
    "action_type": "TOOL_CALL",
    "action_name": "search_database",
    "action_status": "success",
    "sequence": 42,
    "hash": "sha256...",
    "timestamp": "2026-02-17T10:30:00Z"
  }
]

​
GET /v1/events/:id

Get a single event by ID.

​
Example

curl http://localhost:7600/v1/events/550e8400-e29b-41d4-a716-446655440000
Returns 404 if the event is not found.

​
GET /v1/search

Full-text search across events.

​
Query parameters

ParameterTypeDescription
qstringSearch query
limitintegerMax results
offsetintegerPagination offset

​
Example

curl "http://localhost:7600/v1/search?q=search_database&limit=10"

​
GET /v1/agents

List all agents with event counts and chain status.

​
Example

curl http://localhost:7600/v1/agents

​
Response

[
  {
    "agent_id": "my-agent",
    "event_count": 150,
    "last_activity": "2026-02-17T10:30:00Z",
    "chain_valid": true
  }
]

​
GET /v1/stats

Aggregate statistics about the audit trail.

​
Example

curl http://localhost:7600/v1/stats

​
Response

{
  "total_events": 1500,
  "events_last_24h": 42,
  "active_agents": 5,
  "chain_health": 1.0
}