API reference
Endpoints, parameters, and responses generated from the canonical trust8004 OpenAPI contract.
This page is rendered from the same OpenAPI object served by trust8004. Changes to the contract therefore fail the documentation build instead of silently drifting.
Download the canonical OpenAPI JSON →
/api/v1/catalog/agentsList agents from the free catalogFree marketplace-oriented catalog. It currently supports the same filters and returns the same representation as the paid search endpoint. Traverse all agents with consecutive offsets of up to 100 rows; filter one or more chains with chainIds; request the newest registrations with sortBy=registered&sortOrder=desc. Future revisions may apply a smaller page cap, cursor pagination, and a summary projection while preserving this URL.
Parameters
searchSearch text. All-digit values ("42") match agent ids and "{chainId}:{agentId}" ("8453:42") matches one agent exactly. Any other text searches agent names and descriptions and must contain searchable characters, be 2 to 200 characters long, and contain at most 12 terms.
chainIdsComma-separated EVM chain ids to filter by, e.g. "8453,56". Omit for all chains.
ownerFilter to agents owned by this EVM address (0x...).
activeSet "true" to return only agents not revoked/deactivated.
offsetNumber of agents to skip, for pagination (default 0). Negative or invalid values are treated as 0.
sortBySort field: "registered" (registration time, default), "reputation", or "likes".
sortOrderSort direction: "desc" (default) or "asc".
limitMaximum number of agents to return (default 50, currently capped at 100).
/api/v1/catalog/agents/{id}Get one agent from the free catalogFree marketplace-oriented agent profile. It currently returns the same representation as the paid detail endpoint; a future revision may reduce it to a stable summary projection.
Parameters
idrequiredComposite agent id "{chainId}:{agentId}", e.g. "8453:42".
/api/v1/chainsList indexed chainsFree discovery endpoint for the chains and ERC-8004 registries indexed by trust8004.
/api/v1/chains/{chainId}Get indexed chain detailsParameters
chainIdrequiredNumeric chain id to inspect.
/api/v1/agentsSearch registered ERC-8004 agentsSearch and list AI agents registered in the ERC-8004 identity registries indexed by trust8004. Supports full-text search, chain and owner filters, and reputation-based sorting.
Parameters
searchSearch text. All-digit values ("42") match agent ids and "{chainId}:{agentId}" ("8453:42") matches one agent exactly. Any other text searches agent names and descriptions and must contain searchable characters, be 2 to 200 characters long, and contain at most 12 terms.
chainIdsComma-separated EVM chain ids to filter by, e.g. "8453,56". Omit for all chains.
ownerFilter to agents owned by this EVM address (0x...).
activeSet "true" to return only agents not revoked/deactivated.
offsetNumber of agents to skip, for pagination (default 0). Negative or invalid values are treated as 0.
sortBySort field: "registered" (registration time, default), "reputation", or "likes".
sortOrderSort direction: "desc" (default) or "asc".
limitMaximum number of agents to return (default 50, capped at 100). For larger pages use /api/v1/agents/bulk.
/api/v1/agents/bulkBulk-list registered ERC-8004 agentsVolume tier of the agent search: identical filters and response shape, but pages of up to 1000 agents per call. Paginate with offset to retrieve the full filtered dataset.
Parameters
searchSearch text. All-digit values ("42") match agent ids and "{chainId}:{agentId}" ("8453:42") matches one agent exactly. Any other text searches agent names and descriptions and must contain searchable characters, be 2 to 200 characters long, and contain at most 12 terms.
chainIdsComma-separated EVM chain ids to filter by, e.g. "8453,56". Omit for all chains.
ownerFilter to agents owned by this EVM address (0x...).
activeSet "true" to return only agents not revoked/deactivated.
offsetNumber of agents to skip, for pagination (default 0). Negative or invalid values are treated as 0.
sortBySort field: "registered" (registration time, default), "reputation", or "likes".
sortOrderSort direction: "desc" (default) or "asc".
limitMaximum number of agents to return (default 1000, capped at 1000).
/api/v1/agents/{id}Get one agent profileFull indexed profile for a single registered agent: identity, owner, registration metadata, endpoints, and status.
Parameters
idrequiredComposite agent id "{chainId}:{agentId}", e.g. "8453:42" for agent 42 on Base.
/api/v1/agents/{id}/scoreGet an agent trust scoreComputed trust score for one agent: 0-100 total, tier (unverified, bronze, silver, gold, platinum, diamond), and a per-dimension breakdown with weights and confidence.
Parameters
idrequiredComposite agent id "{chainId}:{agentId}", e.g. "8453:42". A bare agent id works if chainId is passed as a query parameter.
chainIdEVM chain id of the agent; only needed when {id} is not composite.
refreshSet "true" to force recomputation instead of the cached score.