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

{
  "agent_id": 1,
  "owner": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "metadata": {
    "name": "Example Agent",
    "description": "An example AI agent registered on-chain",
    "image": "ipfs://QmExample123"
  }
}

​
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)
​
metadata
object
Agent registration metadata from tokenURI (null if unavailable)
​
metadata.name
string
Agent name from registration metadata
​
metadata.description
string
Agent description from registration metadata
​
metadata.image
string
Agent image URI from registration metadata
curl -X GET "https://api.credprotocol.com/api/v2/agents/1" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "agent_id": 1,
  "owner": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "metadata": {
    "name": "Example Agent",
    "description": "An example AI agent registered on-chain",
    "image": "ipfs://QmExample123"
  }
}

​
Performance

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