Skip to main content
GET
/
api
/
v2
/
agents
curl -X GET "https://api.credprotocol.com/api/v2/agents?page=1&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "agents": [
    {
      "agent_id": 1,
      "owner": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "metadata": {
        "name": "DeFi Score Agent",
        "description": "Credit scoring for DeFi protocols",
        "image": "ipfs://QmExample1"
      }
    },
    {
      "agent_id": 2,
      "owner": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "metadata": {
        "name": "Sybil Detector",
        "description": "Sybil detection and identity verification",
        "image": "ipfs://QmExample2"
      }
    },
    {
      "agent_id": 3,
      "owner": "0x1234567890abcdef1234567890abcdef12345678",
      "metadata": null
    }
  ],
  "total": 42,
  "page": 1,
  "limit": 10
}

Documentation Index

Fetch the complete documentation index at: https://docs.credprotocol.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Returns a paginated list of agents from the ERC-8004 Identity Registry on Base, including each agent’s owner address. Use this to discover valid agent IDs for 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

​
Query Parameters

​
page
integer
default:"1"
Page number (must be >= 1)
​
limit
integer
default:"20"
Number of agents per page (1-100)

​
Response

​
agents
array
Array of agent objects on this page
​
agents[].agent_id
integer
The ERC-8004 agent ID (ERC-721 token ID)
​
agents[].owner
string
Ethereum address of the agent’s owner (checksummed)
​
agents[].metadata
object
Agent registration metadata from tokenURI (null if unavailable)
​
agents[].metadata.name
string
Agent name from registration metadata
​
agents[].metadata.description
string
Agent description from registration metadata
​
agents[].metadata.image
string
Agent image URI from registration metadata
​
total
integer
Total number of agents in the Identity Registry
​
page
integer
Current page number
​
limit
integer
Number of agents per page
Agent IDs are 1-indexed ERC-721 token IDs. Burned or nonexistent tokens are automatically skipped, so a page may return fewer agents than the limit.
curl -X GET "https://api.credprotocol.com/api/v2/agents?page=1&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "agents": [
    {
      "agent_id": 1,
      "owner": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "metadata": {
        "name": "DeFi Score Agent",
        "description": "Credit scoring for DeFi protocols",
        "image": "ipfs://QmExample1"
      }
    },
    {
      "agent_id": 2,
      "owner": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "metadata": {
        "name": "Sybil Detector",
        "description": "Sybil detection and identity verification",
        "image": "ipfs://QmExample2"
      }
    },
    {
      "agent_id": 3,
      "owner": "0x1234567890abcdef1234567890abcdef12345678",
      "metadata": null
    }
  ],
  "total": 42,
  "page": 1,
  "limit": 10
}

​
Use Cases

Browse all registered agents to find valid IDs for reputation feedback submission. Useful for building dashboards or agent directories.

​
Performance

  • Response Time: Typically 1-3 seconds depending on page size
  • Data Source: On-chain ownerOf() calls to the Identity Registry on Base (chain 8453)
  • Maximum Page Size: 100 agents per request