Documentation Index
Fetch the complete documentation index at: https://docs.pecta.ai/llms.txt
Use this file to discover all available pages before exploring further.
GET /v1/reputation/:agentId returns the current reputation score for a single agent within your organization. Pecta serves scores with low latency and keeps them up to date within seconds of each evaluation completing.
The score is a 0–1000 integer that reflects recent quality and consistency. It only becomes statistically meaningful after at least 50 evaluations, which is reflected in the status lifecycle field.
Scoring formula:
score = floor((pass_rate × 400) + (latency_score × 250) + (streak_score × 200) + (volume_score × 150))Where latency_score = max(0, 1 − avg_latency_ms / 100), streak_score = min(streak, 50) / 50, and volume_score = min(evaluations, 500) / 500.Endpoint
Authentication
Required. Pass your API key as a Bearer token:Path parameters
The agent identifier to look up. Must match the
agent_id used at evaluation time.Response fields
The agent identifier.
Current reputation score, 0–1000. Returns
0 for agents that have never been evaluated.Total number of evaluations in the rolling window (max 500).
Number of evaluations in the window that passed all gates.
Fraction of evaluations that passed, expressed as a decimal between 0 and 1.
Average gate evaluation latency across the rolling window in milliseconds.
Number of consecutive passing evaluations counting back from the most recent event.
Lifecycle stage of the agent:
| Value | Condition | Meaning |
|---|---|---|
"new" | 0 evaluations | No data yet |
"calibrating" | 1–49 evaluations | Score building — treat as indicative only |
"active" | 50–499 evaluations | Statistically reliable score |
"mature" | 500+ evaluations | Full rolling window — most accurate |
New agent response
When no evaluations exist for the requestedagentId, the API returns 200 with a zeroed-out record rather than 404. This makes it safe to poll the endpoint before an agent has run any evaluations.