Skip to main content
GET
Look up an agent in the global registry

Authorizations

X-API-Key
string
header
required

Organization API key.

Path Parameters

did
string
required

The agent's AP2 DID, A2A id, or 0x wallet address (URL-encoded).

Response

Agent found in the registry.

ap2Did
string
Example:

"did:ap2:example:agent-1"

a2aId
string | null
name
string
description
string | null
category
enum<string>
Available options:
SERVICES,
GOODS,
DATA,
COMPUTE,
FINANCIAL,
OTHER
status
enum<string>
Available options:
PENDING,
VERIFIED,
SUSPENDED
provenance
enum<string>

observed = auto-discovered on-chain; claimed = held by an organization; verified = ownership cryptographically proven.

Available options:
observed,
claimed,
verified
walletAddress
string | null
marketplaces
string[]
activityScore
number

0-100, computed from observed on-chain payments.

verifiedAt
string<date-time> | null
reputationScore
number
tier
enum<string>
Available options:
unproven,
bronze,
silver,
gold,
platinum
successCount
integer
failureCount
integer
disputeCount
integer
totalVolume
number
stakedAmount
number
transactionCapacity
number