Getting Started
Welcome to YounndAI Domains — the typed vocabulary layer for AI agents.
Welcome to YounndAI Domains — the typed vocabulary layer that lets AI agents speak the same language across industries.
What is YounndAI Domains?
YounndAI Domains is a curated, versioned registry of domain schemas — typed vocabularies describing real-world concepts like patients, payments, shipments, and policies. Each domain defines:
- Tags — Named groups of related fields (e.g.,
demographics,vitals) - Fields — Typed attributes with descriptions, enums, and validation rules
- Trust signals — Publisher verification, conformance scoring, and operational health
When an AI agent references a domain schema, it knows exactly what fields to expect, what types they are, and how to validate them — without any prior integration.
The Vocabulary Thesis
YON provides the grammar. Domains provides the vocabulary.
YON (YounndAI Object Notation) defines how to structure data. Domains defines what the data means. When both are shared, zero-integration interoperability emerges.
💡Tip
Think of it like human language: grammar (YON) tells you how to form sentences, but vocabulary (Domains) gives you the words to say something meaningful.
Quick Start
Fetch any domain schema with a single GET request:
GET /api/domains/yon.health
{
"domain": "yon.health",
"version": "1.0",
"status": "active",
"description": "Healthcare domain covering patient data and clinical records",
"records": {
"VITALS": {
"description": "Patient vital signs",
"fields": {
"bp": { "type": "string", "required": true, "description": "Blood pressure reading" },
"hr": { "type": "int", "required": false, "range": [30, 250] },
"temp_c": { "type": "float", "required": false, "range": [30.0, 45.0] }
}
}
}
}