---
title: "DORA Register of Information (RoI) Builder & Cross-Validator"
method: POST
path: "/v1/tools/build_dora_roi_register"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# DORA Register of Information (RoI) Builder & Cross-Validator

`POST /v1/tools/build_dora_roi_register`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/build_dora_roi_register`
- Auth: none declared

Constructs and cross-validates the core Register of Information (RoI) template relationships required under DORA (EU 2022/2554) Art. 28/30: entity + ICT third-party providers + functions + contractual arrangements. Validates ISO 17442 LEI format + mod-97 check-digit on the entity and every provider, referential integrity (every function's provider_id, every contract's function_id and provider_id, and function-to-contract provider consistency), and mandatory-field completeness per record type, emitting a form-shaped JSON dataset plus a validation report with per-record findings and compliance_flags. Distinct from the RoI's official xBRL-CSV submission format, which this kernel does NOT emit (a later WU handles ESA-format conversion). Distinct from art-467-dora-incident-classifier (this validates the standing RoI dataset; that classifies a single ICT incident's reporting obligations). Criticality of functions/providers is a caller-declared flag, not judged here.

**Tool URL:** https://ainumbers.co/chaingraph/art-466-dora-roi-builder.html

## Request body

- object
  - `contracts` unknown, required
  - `entity` unknown, required
  - `functions` unknown, required
  - `providers` unknown, required

## Response `200`

Successful tool execution result

- object
  - `contracts` object[]
    - `contract_id` string
    - `contract_reference` string
    - `end_date` string
    - `function_id` string
    - `governing_law` string
    - `provider_id` string
    - `start_date` string
  - `entity` object
    - `entity_lei` string
    - `entity_name` string
  - `functions` object[]
    - `critical` boolean
    - `function_id` string
    - `function_type` string
    - `name` string
    - `provider_id` string
  - `note` string
  - `providers` object[]
    - `country` string
    - `lei` string
    - `name` string
    - `provider_id` string
    - `service_type` string
  - `validation_report` object
    - `compliance_flags` unknown[]
      - unknown
    - `findings` object[]
      - `check` string
      - `message` string
      - `record_id` string
      - `record_type` string
      - `status` string
    - `summary` object
      - `checks` object
        - `lei_validity` object
          - `fail` integer
          - `pass` integer
        - `mandatory_fields` object
          - `fail` integer
          - `pass` integer
        - `referential_integrity` object
          - `fail` integer
          - `pass` integer
      - `contract_count` integer
      - `entity_count` integer
      - `function_count` integer
      - `overall_pass` boolean
      - `provider_count` integer
    - `table_source` string
    - `table_version` string

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)