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
string
required
The agent identifier to look up. Must match the
agent_id used at evaluation time.Response fields
string
The agent identifier.
number
Current reputation score, 0–1000. Returns
0 for agents that have never been evaluated.number
Total number of evaluations in the rolling window (max 500).
number
Number of evaluations in the window that passed all gates.
number
Fraction of evaluations that passed, expressed as a decimal between 0 and 1.
number
Average gate evaluation latency across the rolling window in milliseconds.
number
Number of consecutive passing evaluations counting back from the most recent event.
string
Lifecycle stage of the agent:
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.