Data Models

This section describes the data structures returned by the Revolutio API. The primary object is the Entity, which represents a company or natural person returned from a registry search.

Overview

Entity
 +-- addresses[]        → Address
 +-- activities[]       → Activity
 +-- capital            → Capital
 +-- financials         → Financials
 +-- identifiers[]      → Identifier
 +-- lei                → LEI
 +-- otherNames[]       → OtherName
 +-- relationships[]    → Relationship
 +-- sourceDocuments[]  → SourceDocument
 +-- counterparties[]   → Entity (nested)
 +-- participations[]   → Participation

All fields are optional unless noted otherwise. Which fields are populated depends on the jurisdiction and what the source registry exposes for that entity.

Where entities appear

Location	Endpoint	Notes
result	GET /search/{id}/status	Full entity from that search
target	GET /casefile/{caseId}	Live case graph (root + nested counterparties)
Nested counterparties[]	Same	Officers, shareholders, related companies

Sub-models

Model	Description
Entity	Company or person
Address	Registered / HQ / other addresses (raw or ISO 20022)
Identifier	Registration numbers and tax IDs
Relationship	Officers, shareholders, UBOs, etc.
Activity	NACE / SIC / industry codes
Capital	Share capital structure
Financials	Opt-in financial metrics