Open spec

names.json v1.0 draft

An open, machine-readable identity manifest hosted at /.well-known/names.json. Sellers publish it; agent buyers consume it; names.dev indexes it as agent-readable inventory.

Example

{
  "spec": "https://names.dev/schema/v1/names.schema.json",
  "version": "1.0",
  "name": "Example",
  "domains": [
    {
      "domain": "example.ai",
      "status": "make_offer",
      "asking_price": {"amount": 25000, "currency": "USD", "display": true},
      "minimum_offer": {"amount": 10000, "currency": "USD", "display": false}
    }
  ],
  "handles": {
    "x": "@example",
    "github": "example"
  },
  "categories": ["ai", "developer-tools"],
  "owner_verification": {
    "method": "dns_txt",
    "verified_by": "names.dev",
    "verified_at": "2026-05-11T00:00:00Z"
  },
  "agent_offers_enabled": true,
  "human_approval_required": true,
  "escrow_supported": true,
  "lease_to_own": true,
  "offer_endpoint": "https://names.dev/api/offers/example"
}

DNS-compact form

_names.example.ai TXT "v=NAMES1; status=make_offer; min=10000; currency=USD; verify=<hash>"