# .Odin Foundation

> ODIN-L (Open Data Interchange Notation Language) is a canonical data model for transporting meaning between systems, standards, and AI.

ODIN is an open-source data interchange format designed for unambiguous, typed, compact data representation. It uses self-describing value prefixes (# for numbers, ## for integers, #$ for currency, ? for booleans, @ for references, ^ for binary, ~ for null) so parsers and LLMs can identify types without schema lookup. ODIN produces deterministic output (same data = same bytes), enabling hashing, digital signatures, and deduplication.

Key properties:
- 30% fewer tokens than equivalent JSON (measured across 337 schemas)
- 40% smaller payloads than JSON with identical semantic content
- Self-describing types eliminate parsing ambiguity
- Deterministic serialization enables hashing and signatures
- Inline modifiers: required (!), confidential (*), deprecated (-)
- Declarative transform engine with 255 built-in verbs

Author: Laird Rixford (https://github.com/lrixford)
License: Specifications under CC-BY 4.0, code under Apache 2.0
Repository: https://github.com/odin-foundation

## Specification Reference

The complete ODIN 1.0 language specification covering notation, value types, sections, paths, arrays, tables, modifiers, and directives.

- ODIN Specification Reference: https://odin.foundation/reference
- Schema Reference (type definitions, constraints, validation): https://odin.foundation/reference/schema
- Transform Reference (declarative mapping and format conversion): https://odin.foundation/reference/transform
- Forms Reference (declarative form layouts, fields, rendering): https://odin.foundation/reference/forms

## Transform Verbs

ODIN includes a declarative transform engine for mapping data between formats (JSON, XML, CSV, fixed-width) and ODIN. Transform verbs are organized by category:

- String & Case Conversion Verbs: https://odin.foundation/reference/transform/verbs/string
- Numeric Verbs: https://odin.foundation/reference/transform/verbs/numeric
- Financial & Statistical Verbs: https://odin.foundation/reference/transform/verbs/financial
- Date & Time Verbs: https://odin.foundation/reference/transform/verbs/datetime
- Conditional Verbs: https://odin.foundation/reference/transform/verbs/conditional
- Lookup Verbs: https://odin.foundation/reference/transform/verbs/lookup
- Aggregation Verbs: https://odin.foundation/reference/transform/verbs/aggregation
- Array Verbs: https://odin.foundation/reference/transform/verbs/array
- Type Coercion & Encoding Verbs: https://odin.foundation/reference/transform/verbs/coercion

## Schema Library

337 production-ready schemas defining 2666 types across 55189 fields. Schemas cover insurance, healthcare, finance, legal, real estate, government, and more. Each schema is derived from authoritative industry sources (ACORD, HL7 FHIR, FpML, ALTA, MISMO, etc.) and includes full derivation provenance.

### Sectors

- Agriculture (7 schemas): https://odin.foundation/schemas/agriculture
- Automotive (6 schemas): https://odin.foundation/schemas/automotive
- Common (2 schemas): https://odin.foundation/schemas/common
- Construction (9 schemas): https://odin.foundation/schemas/construction
- Education (7 schemas): https://odin.foundation/schemas/education
- Employment (10 schemas): https://odin.foundation/schemas/employment
- Finance (11 schemas): https://odin.foundation/schemas/finance
- Government (14 schemas): https://odin.foundation/schemas/government
- Healthcare (57 schemas): https://odin.foundation/schemas/healthcare
- Insurance (138 schemas): https://odin.foundation/schemas/insurance
- Legal (14 schemas): https://odin.foundation/schemas/legal
- Logistics (6 schemas): https://odin.foundation/schemas/logistics
- Manufacturing (7 schemas): https://odin.foundation/schemas/manufacturing
- Mortgage (3 schemas): https://odin.foundation/schemas/mortgage
- Real Estate (23 schemas): https://odin.foundation/schemas/realestate
- Retail (8 schemas): https://odin.foundation/schemas/retail
- Telecom (8 schemas): https://odin.foundation/schemas/telecom
- Utilities (7 schemas): https://odin.foundation/schemas/utilities

All schemas are available as raw ODIN source. The raw and bundled (flattened) URLs for each schema are content-addressed (hashed) for cache-friendliness; resolve a slug to its current URL via the schema manifest at `https://odin.foundation/api/schemas/manifest.odin`.

- Raw schema (with derivation, comments, import refs): per slug in the manifest as `raw`
- Bundled schema (imports inlined, derivation stripped, ready for tooling): per slug in the manifest as `bundled`
- Search index: https://odin.foundation/api/schemas/search-index.odin

## SDKs

Parse, validate, and transform ODIN documents in multiple languages:

- TypeScript: @odin-foundation/core (full parser, serializer, schema validator, transform engine)
- Rust: High-performance SDK for systems programming
- .NET: C# SDK for enterprise integrations
- Java: JVM SDK for enterprise systems
- Python: SDK for data science and AI pipelines
- Ruby: SDK for web applications

SDK documentation: https://odin.foundation/sdk

## Interactive Tools

- Playground (convert JSON/XML/YAML to ODIN with live preview): https://odin.foundation/playground
- Transform Lab (experiment with transforms in real time): https://odin.foundation/transform-lab
- Form Builder (drag-and-drop visual form editor, exports .form.odin): https://odin.foundation/form-builder

## API Endpoints

- Schema manifest (slug → hashed URLs): `https://odin.foundation/api/schemas/manifest.odin`
- Search index: `https://odin.foundation/api/schemas/search-index.odin`
- Sitemap: https://odin.foundation/sitemap.xml

Each manifest entry contains: `raw` (display form, includes derivation), `bundled` (flattened, no derivation), `filename` (download name), `bundledFilename` (download name).

## About

https://odin.foundation/about