Skip to main content
GET
https://api.credprotocol.com
/
api
/
v2
/
reputation
/
agents
/
{agent_id}
curl -X GET "https://api.credprotocol.com/api/v2/reputation/agents/1" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "agent_id": 1,
  "owner": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
}

Overview

Returns whether an agent exists in the ERC-8004 Identity Registry on Base, along with its owner address. Use this to validate an agent ID before submitting reputation feedback.
This is a free endpoint (0 Cred Units). It reads directly from the on-chain Identity Registry contract on Base.

Authentication

MethodHeaderCost
API TokenAuthorization: Bearer YOUR_API_KEY0 Cred Units
x402 PaymentX-PAYMENT: <signed_payment>Free

Path Parameters

agent_id
integer
required
ERC-8004 agent ID (ERC-721 token ID in the Identity Registry). Must be >= 1.

Response

agent_id
integer
The ERC-8004 agent ID
owner
string
Ethereum address of the agent’s owner (checksummed)
curl -X GET "https://api.credprotocol.com/api/v2/reputation/agents/1" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "agent_id": 1,
  "owner": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
}

Performance

  • Response Time: Typically under 1 second
  • Data Source: On-chain ownerOf() call to the Identity Registry on Base (chain 8453)