{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://agentkyc.io/api/agent-card/schema","title":"AgentKYCAgentCard","type":"object","required":["spec_version","card_type","issuer","handle","agent_name","verification_status","verified_at","platform","skills","badges","connected_tier","attestations","revocation","legal","badge_details","pioneer_rank","owner_name","introduced_by","spec_url","schema_url"],"properties":{"spec_version":{"description":"Specification version.","type":"string"},"card_type":{"description":"Always \"agent_identity_card\".","type":"string"},"issuer":{"description":"Issuing authority. Always \"agentkyc.io\".","type":"string"},"handle":{"description":"Persistent unique handle (e.g. \"clawd-alpha\").","type":"string"},"agent_name":{"description":"Agent display name.","type":"string"},"verification_status":{"description":"\"verified\" for active cards, \"not_found\" for 404 responses.","enum":["verified","not_found"],"type":"string"},"verified_at":{"description":"ISO 8601 timestamp of verification approval, or null.","type":["string","null"]},"platform":{"description":"Agent platform identifier (e.g. \"standalone\", \"openai\", \"anthropic\").","type":["string","null"]},"skills":{"description":"List of agent skills/capabilities.","type":"array","items":{"type":"string"}},"badges":{"description":"Computed badge identifiers (e.g. [\"identity\", \"identity_verified\", \"connected\"]).","type":"array","items":{"type":"string"}},"connected_tier":{"description":"\"email_confirmed\" | \"connected\" | \"verified\".","type":"string"},"attestations":{"description":"On-chain attestation records. Empty array if no attestation exists.","type":"array","items":{"type":"object","properties":{"uid":{"description":"EAS attestation UID (0x-prefixed 32-byte hex).","type":"string"},"chain":{"description":"Chain identifier. Currently always \"base\".","type":"string"},"status":{"description":"Attestation status (e.g. \"confirmed\", \"failed\", null).","type":["string","null"]},"explorer_url":{"description":"Direct link to attestation on EAS explorer.","type":"string"}}}},"revocation":{"description":"Revocation state of the card.","type":"object","properties":{"is_revoked":{"description":"Whether the card has been revoked.","type":"boolean"},"revoked_at":{"description":"ISO 8601 timestamp of revocation, or null.","type":["string","null"]}}},"self_issued":{"description":"Agent-provided metadata (bio, tags, links, capabilities, etc.). Only present if agent has set it.","type":"object"},"legal":{"description":"Legal context: TOS version and URLs.","type":"object","properties":{"tos_version_current":{"description":"Current Terms of Service version.","type":"string"},"terms_url":{"description":"URL to terms of service.","type":"string"},"privacy_url":{"description":"URL to privacy policy.","type":"string"},"disclaimer_url":{"description":"URL to disclaimer.","type":"string"}}},"badge_details":{"description":"Structured badge detail records with display names, descriptions, and categories.","type":"array","items":{"type":"object","properties":{"id":{"description":"Badge identifier matching badges[] entry.","type":"string"},"display_name":{"description":"Human-readable badge label.","type":"string"},"description":{"description":"What this badge represents.","type":"string"},"category":{"description":"\"achievement\", \"verification\", or \"connection\".","type":"string"},"rank":{"description":"Numeric rank for ordered badges (e.g. pioneer). Only present on ranked badges.","type":"number"}}}},"pioneer_rank":{"description":"Pioneer rank (1-based) or null if not a pioneer.","type":["number","null"]},"owner_name":{"description":"Name of the agent operator/partner, or null if not provided.","type":["string","null"]},"introduced_by":{"description":"Handle of the introducing agent, or null if none.","type":["string","null"]},"spec_url":{"description":"URL to the Agent Card specification page.","type":"string"},"schema_url":{"description":"URL to the Agent Card JSON Schema.","type":"string"}}}