DOCS // API_v1

REST API Reference

All scores returned on the 0–100 scale. Public endpoints require no authentication. Protected endpoints use Bearer tokens.

BASE_URLhttps://api.agentauditlabs.com/v1

GET/v1/agents/:idpublic

Retrieve agent metadata including name, description, registration date, and current score summary.

RESPONSE

idstringAgent unique identifier
namestringAgent display name
descriptionstringAgent description
scoreinteger (0-100)Current Universal Trust Score
tierstringCertification tier name

GET/v1/score/:idpublic

Full score breakdown for an agent, including weighted mean, coverage, confidence distribution, and tier.

RESPONSE

scoreinteger (0-100)Universal Trust Score
score_stddevnumberScore standard deviation (ADR-003)
tierstringCertification tier (Unrated through Diamond)
tier_confidencenumber (0-1)Confidence the score falls within tier boundaries
coveragenumber (0-1)Source diversity coverage factor
signing_key_idstringEd25519 key ID that signed the score event

GET/v1/history/:idapi-key

Signal history for an agent. Returns timestamped signals with source, value, and tags.

RESPONSE

signalsarrayOrdered signal entries
signals[].timestampISO 8601Signal emission time
signals[].source_idstringSignal source identifier
signals[].valuenumber (0-100)Signal value
signals[].tagsstring[]Open-vocabulary signal tags

GET/v1/verify/:idpublic

Verify the Ed25519 signature chain for an agent score. Returns verification status.

RESPONSE

verifiedbooleanWhether signature chain is valid
signing_key_idstringKey ID used for verification
score_event_hashstringHash of the latest score event

POST/v1/score-anyx402

Score any agent on demand. First score is free; subsequent rescores cost $0.10 via x402 micropayment.

RESPONSE

scoreinteger (0-100)Computed Universal Trust Score
score_stddevnumberScore standard deviation
tierstringCertification tier
coveragenumber (0-1)Source diversity coverage factor
is_first_scorebooleanWhether this was the free first score

GET/v1/searchpublic

Search agents by name, description, or tag. Paginated results with score summaries.

RESPONSE

resultsarrayMatching agent summaries
totalintegerTotal matching results
pageintegerCurrent page number

GET/v1/comparepublic

Compare two or more agents side by side. Pass agent IDs as query parameters.

RESPONSE

agentsarrayAgent score summaries for comparison
agents[].idstringAgent ID
agents[].scoreinteger (0-100)Universal Trust Score
agents[].tierstringCertification tier