---
title: "LEI Relationship Consistency Checker"
method: POST
path: "/v1/tools/check_lei_relationship_consistency"
tags: ["TODO_TAGS_REVIEW"]
---

# LEI Relationship Consistency Checker

`POST /v1/tools/check_lei_relationship_consistency`

## Request

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

Checks four structural invariants over a pasted set of GLEIF Level-2 relationship records for one subject LEI: every startNode and endNode is a syntactically valid LEI (ISO 17442 mod-97, the same check art-246 carries), walking IS_DIRECTLY_CONSOLIDATED_BY edges never revisits a node already on the current path, every reporting-exception code is a published GLEIF category held as a versioned constant rather than inferred, and no two active records share a startNode, endNode and relationshipType triple with overlapping validity periods. A violation flags a possible inconsistency in GLEIF's published Level-2 data for this LEI. It is not an assertion about the entity's actual corporate structure and not a finding about the entity itself; golden-copy data is periodically corrected, so recheck against a fresh pull before treating any violation as durable. An empty record set returns consistent as null rather than a clean pass. Zero network: this never queries GLEIF and is not a re-implementation of GLEIF's own reconciliation service.

**Tool URL:** https://ainumbers.co/chaingraph/art-600-lei-relationship-consistency.html
**AP2/Policy Mandate export:** yes

## Request body

- object
  - `relationships` unknown[], required
    - unknown
  - `subject_lei` unknown, required

## Response `200`

Successful tool execution result

- object
  - `consistent` boolean
  - `cycle_path` string
  - `deprecated_exception_codes` unknown[]
    - unknown
  - `duplicate_active_triples` unknown[]
    - unknown
  - `exception_table_source` string
  - `exception_table_version` string
  - `invalid_node_leis` unknown[]
    - unknown
  - `invariant_results` object[]
    - `code` string
    - `detail` string
    - `invariant` string
    - `pass` boolean
  - `pii_note` string
  - `recognized_exception_codes_current` string[]
  - `recognized_exception_codes_deprecated` string[]
  - `record_count` integer
  - `records_assessed` boolean
  - `scope_note` string
  - `subject_lei` string
  - `subject_lei_valid` boolean
  - `unrecognized_exception_codes` unknown[]
    - unknown
  - `violation_count` integer
  - `violations` unknown[]
    - unknown

---

[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)