Resolver API

The resolver is the public, read-only layer of IDN. It is the DNS equivalent for agent handles. No authentication required. Cached at the edge with a one-hour TTL.

Endpoint

GET https://resolver.idn.global/v1/{handle}

Response

{
  "handle": "@alice.payments",
  "kind": "individual",
  "scenario": "payments",
  "tier": 1,
  "publicKey": { "kid": "k1", "alg": "EdDSA", "x": "Z3Nh..." },
  "reservedAt": "2026-11-04T12:00:00Z",
  "expiresAt":  "2027-11-04T12:00:00Z",
  "status": "active",
  "portable": true,
  "upgradable": true
}

Errors

• 404: handle_not_found
• 410: handle_revoked
• 403: handle_grace_period

Rate limits

Anonymous: 1000 req/min per IP, 10× burst. Authenticated API keys (Tier 2) lift this to 100K req/min.