agents

Resolve agent identity by handle, email, or account ID (x402-paid)

Discover and resolve an agent's full identity profile from a partial identifier. Public endpoint — no API key required. Anonymous callers pay 0.005 USDC via x402 (payment IS authentication). Returns DID, JWKS URL, registration date, and verification status.

get/v1/agents/lookup

Request

  • Base URL: https://agentlair.dev
  • URL: https://agentlair.dev/v1/agents/lookup
  • Auth: none required

Query parameters

handlestring
Example:research-agent

Agent handle (name part of @agentlair.dev email)

emailstring
Example:research-agent@agentlair.dev

Full @agentlair.dev email address

idstring
Example:acc_demoid12345

Agent account ID (acc_...)

Response

Agent identity profile

idstring required
namestring required
emailstring required
didstring required
jwks_urlstring required
registered_atstring date-time required
verifiedboolean required

Example response

{
  "id": "acc_demoid12345",
  "name": "research-agent",
  "email": "research-agent@agentlair.dev",
  "did": "did:web:agentlair.dev:agents:acc_demoid12345",
  "jwks_url": "https://agentlair.dev/agents/acc_demoid12345/.well-known/jwks.json",
  "verified": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.