Skip to content
RUMLRUML

Open Format for Digital Law

RUML – Rulemapping Logic Format

RUML is an open, JSON-based file format for the machine-executable representation of legal decision logic. This specification defines the format: its structure, its extension mechanism, and the requirements an implementation must satisfy to be conformant.

RUML stands for Rulemapping Logic. The format does not mark up legislative text; it holds the decision logic as an artifact of its own and references the wording.

Status of This Document

Version 1.0.0 / November 15, 2026

Published by Law as Code Institut GmbH. Rulemapping Group GmbH holds the rights to this specification.

License

This specification is licensed under Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0). It may be copied, redistributed, translated and adapted, including for commercial purposes, provided the rights holder is credited and adaptations are distributed under the same license.

Attribution:

RUML – Rulemapping Logic Format, version 1.0.0, © Rulemapping Group GmbH, published by Law as Code Institut GmbH, licensed under CC BY-SA 4.0.

The license covers the document, not the format. Building a runtime environment, producing, processing or exchanging RUML files requires no license and no permission. The ShareAlike condition applies to adaptations of this text. It does not extend to software that implements the format, nor to rulemaps created in it; rulemaps remain with their authors.

The JSON Schemas, the conformance tests and the examples are licensed under the Apache License 2.0.

Authoritative Version

The English version is authoritative. The German version is a translation. Where the two differ, the English wording governs.

How to Cite

Rulemapping Group GmbH: RUML – Rulemapping Logic Format. Version 1.0.0. Law as Code Institut GmbH, November 15, 2026.

https://ruml.org/1.0.0/

A reference to a single provision names the chapter: RUML 1.0.0, Chapter 4.6 (Parser Obligations).

Versions and Addresses

This versionhttps://ruml.org/1.0.0/
Latest versionhttps://ruml.org/
Change historyChange history

A published version stays available unchanged at its version address. A citation or a reference in another document uses the version address, not the latest one.

The format carries its own versioning in the $specVersion field. That is a separate matter, governed by Chapter 2.3.

Trademark

RUML is a trademark of Rulemapping Group GmbH; an application for registration as an EU trade mark has been filed. Referring to the format is free: statements such as “supports RUML” or “RUML-compatible” are permitted where they are accurate. Files, software and services that do not conform to this specification may not be labelled RUML. An adapted or derived version of this specification may not be called RUML.

Structure of This Specification

ChapterSubject
1 IntroductionScope, notation, terminology, conformance
2 File Format BasicsJSON layout, versioning, integrity, identifiers
3 Data ModelMetadata, rulemap, nodes, operators
4 CapabilitiesExtension mechanism, ruml: capabilities, third-party namespaces
5 Result FormatRUML-Result
6 Modular NodesReuse, recursion, nesting
7 ContainerPackaging, hashing, signatures, encryption
8 ValidationRule catalogue for conformant parsers
AppendixA. Spec Test Suite: conformance suite and runner contract (informative)

Where to start. A first reader begins with Chapter 1.1 (Scope) and 1.4 (Conformance). An implementer building a runtime environment reads Chapters 2, 3, 4, 5, 6, 7 and 8 together and checks the implementation against the conformance suite in Appendix A. How RUML relates to Akoma Ntoso, DMN and LegalRuleML is set out in Chapter 1.5.

Feedback

Errors, ambiguities and contradictions in this specification can be reported through law-as-code.org/contact or as an issue on GitHub. Proposals for changes to the specification text are welcome the same way; pull requests are not accepted at present.