GET /v1/events — list evaluation events

GET /v1/events returns a paginated list of evaluation events scoped to your organization. Each event records the gate results, latency, overall verdict, and reputation score at the time of evaluation. Events are returned in reverse chronological order — newest first. Results are always isolated to your organization. There is no way to retrieve events from another organization, even with a valid key.

Endpoint

GET https://api.pecta.ai/v1/events

Authentication

Required. Pass your API key as a Bearer token:

Authorization: Bearer pk_live_<your-key>

Query parameters

number

default:"50"

Maximum number of events to return. Minimum 1, maximum 100.

number

default:"0"

Number of events to skip before returning results. Use with limit to paginate. Maximum 100000.

string

Filter to events for a specific agent. Must match exactly. Maximum 200 characters.

string

Filter by gate verdict. Accepts the string "true" or "false". Omit to return events regardless of verdict.

string

Return events on or after this timestamp. ISO 8601 UTC format, e.g. 2026-05-01T00:00:00Z.

string

Return events on or before this timestamp. ISO 8601 UTC format, e.g. 2026-05-07T23:59:59Z.

Response fields

array

Array of event objects, ordered newest first.

Show Event fields

string

Unique event ID.

string

The agent that produced the evaluated output.

string

Tool or function name, if provided at evaluation time.

boolean

Overall gate verdict for this evaluation.

array

Per-gate results at the time of evaluation.

number

Total gate evaluation time in milliseconds.

number

The agent’s reputation score immediately after this evaluation.

string

ISO 8601 UTC timestamp of the evaluation.

number

The limit value applied to this request.

number

The offset value applied to this request.

number

Number of events returned in this response. Less than or equal to limit. Use count < limit to detect the last page.

Example request

curl --get \
  --url "https://api.pecta.ai/v1/events" \
  --header "Authorization: Bearer pk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  --data-urlencode "agent_id=summarizer-v2" \
  --data-urlencode "passed=false" \
  --data-urlencode "from=2026-05-01T00:00:00Z" \
  --data-urlencode "limit=10"

Example response

{
  "events": [
    {
      "id": "evt_4nRpK2mWxZa",
      "agent_id": "summarizer-v2",
      "tool_name": "generate_summary",
      "passed": false,
      "gates": [
        { "name": "filesystem", "passed": true,  "latency_ms": 2 },
        { "name": "pii",        "passed": false, "latency_ms": 5,
          "reason": "output contains email address" },
        { "name": "content",    "passed": true,  "latency_ms": 3 }
      ],
      "total_latency_ms": 10,
      "reputation_score": 584,
      "created_at": "2026-05-06T11:32:44.000Z"
    },
    {
      "id": "evt_9cLqT7vNbYs",
      "agent_id": "summarizer-v2",
      "tool_name": "generate_summary",
      "passed": false,
      "gates": [
        { "name": "filesystem", "passed": true,  "latency_ms": 2 },
        { "name": "pii",        "passed": true,  "latency_ms": 3 },
        { "name": "content",    "passed": false, "latency_ms": 6,
          "reason": "response appears empty" }
      ],
      "total_latency_ms": 11,
      "reputation_score": 571,
      "created_at": "2026-05-03T08:17:02.000Z"
    }
  ],
  "limit": 10,
  "offset": 0,
  "count": 2
}

Overview

Endpoints

GET /v1/events — list evaluation events

Endpoint

Authentication

Query parameters

Response fields

Example request

Example response

​Endpoint

​Authentication

​Query parameters

​Response fields

​Example request

​Example response

Endpoint

Authentication

Query parameters

Response fields

Example request

Example response