Programmatic Intelligence Layer

The Programmatic Intelligence Layer: API Infrastructure

Direct, latency-free access to the DACH+ Corporate Intelligence Coordinate System. We provide the mathematically verified fuel; you provide the compute.

API v1 Live

Request Enterprise Access →

Let’s look at the mechanics of institutional data ingestion. Relying on manual web portals for high-frequency due diligence is a massive structural inefficiency. Your internal models require raw, unvarnished intelligence delivered programmatically. This portal provides direct REST access to the Census Coordinate System™ (CCS)—delivering verified registry data, exact D&O risk scores, the global LEI bridge, and real-time compliance state changes.

Access Tiers & Volumetric Limits

We rate-limit the pipeline to protect the integrity of the cluster, not to artificially restrict data flow. Select the tier that matches the velocity of your quantitative models.

Tier	Rate Limit	Endpoints
Analyst	100 req/min	Entity, Person
Professional	500 req/min	Entity, Person, Contagion, LEI
Enterprise	2,000 req/min	All endpoints + Webhooks

The Security Perimeter: Authentication

All API requests require a Bearer token in the Authorization header. Keys are prefixed fc_live_ (production) or fc_test_ (sandbox).

Example RequestBearer Token

Authorization: Bearer fc_live_<40-char-hex>

curl -X GET "https://www.firmacensus.com/api/v1/enterprise/entity?registry_number=CHE-112.725.607&country=CH" \
  -H "Authorization: Bearer fc_live_..." \
  -H "Accept: application/json"

API Endpoints

GET/api/v1/enterprise/entityanalyst

Entity by Registry Number

Returns the full institutional payload for a legal entity: registry data, board of directors, D&O risk scores, LEI metadata (GLEIF Level 1 + Level 2), and sanctions flags.

Parameters

registry_numberrequiredCHE-112.725.607Jurisdiction artifact — never translated

countryrequiredCHISO 3166-1 alpha-2

Response 200

{
  "data": {
    "entity_id": "uuid",
    "legal_name": "Muster AG",
    "registry_number": "CHE-112.725.607",
    "country_code": "CH",
    "legal_status": "active",
    "board_of_directors": [...],
    "lei_metadata": {
      "LEI": "529900T8BM49AURSDO55",
      "lei_status": "ISSUED"
    },
    "sanctions_flags": [],
    "provenance": {
      "source": "FirmaCensus DACH+ Corporate Intelligence Coordinate System",
      "legal_basis": "GDPR Art. 6(1)(f) & Swiss nDSG Art. 31"
    }
  }
}

GET/api/v1/enterprise/entity/lei/{lei_code}professional

Global LEI Direct Lookup

Bypass country-specific registry routing. Query via ISO 17442 LEI. Returns GLEIF Level 1 data and Level 2 ownership relationships.

Parameters

lei_coderequired529900T8BM49AURSDO55ISO 17442 — 20 alphanumeric chars.

Response 200

{
  "data": {
    "LEI": "529900T8BM49AURSDO55",
    "lei_status": "ISSUED",
    "is_directly_consolidated_by": [
      { "parent_lei": "PARENT_LEI_HERE", "ownership_percentage": 100.0 }
    ],
    "is_ultimately_consolidated_by": [...],
    "firmacensus_entity": { ... }
  }
}

GET/api/v1/enterprise/person/{person_id}/contagionprofessional

Executive Contagion Network

Full network graph for an executive: mandates, co-director overlaps, D&O risk profile, cross-border exposure, and sanctions hits.

Parameters

person_idrequireduuidFirmaCensus internal person UUID

Response 200

{
  "data": {
    "person": { "full_name": "Max Muster", "city": "Zürich" },
    "risk_profile": {
      "risk_tier": "HIGH",
      "composite_score": 78,
      "concurrent_mandates": 12
    },
    "active_mandates": [...],
    "cross_border_exposure": {
      "countries": ["CH", "DE", "AT", "LI"],
      "is_cross_border": true
    },
    "sanctions_flags": []
  }
}

POST/api/v1/enterprise/webhooksenterprise

Create Webhook Subscription

Subscribe to real-time compliance events. compliance.lei_lapsed fires immediately when an entity's LEI status changes from ISSUED to LAPSED.

Parameters

webhook_urlrequiredhttps://crm.example.com/hooks/firmacensusHTTPS required

eventsrequired["compliance.lei_lapsed","entity.board_changed"]Array of event types

lei_codeoptional529900T8BM49AURSDO55Subscribe by LEI

Response 200

{
  "data": {
    "subscription_id": "wh_abc123...",
    "signing_secret": "fc_whsec_...",
    "signing_note": "Store securely. Not shown again.",
    "is_active": true
  }
}

Webhook Events

Risk is not a daily batch process; it is a live, highly volatile variable. State changes are cryptographically verified via HMAC-SHA256. If a critical LEI lapses or a sanctions flag is triggered, the event fires immediately.

Event	Description
`entity.status_changed`	Entity legal status changes (e.g., active → liquidation)
`entity.board_changed`	Board member appointed or resigned
`entity.lei_updated`	LEI metadata updated (status, renewal date)
`compliance.lei_lapsed`	CRITICAL: LEI status changed ISSUED → LAPSED. Fires immediately.
`compliance.lei_retired`	CRITICAL: LEI status changed to RETIRED.
`compliance.sanctions_hit`	New sanctions match detected for a board member.
`person.mandate_changed`	Executive mandate status changes.

Webhooks are verified via HMAC-SHA256. The signing secret is returned once at subscription creation.

The Preservation of Statutory Artifacts

Pay close attention here: we never translate or mutate jurisdiction-specific identifiers. If you force a sovereign statutory artifact into a generic, normalised schema, you destroy its cryptographic provenance. We return the primary commercial code exactly as issued by the sovereign state.

CH · Swiss UID

CHE-112.725.607

DE · Handelsregister

HRB 12345

AT · Firmenbuch FN

537631i

PL · Rejestr KRS

KRS 0000123456

GLEIF · LEI (ISO 17442)

529900T8BM49AURSDO55

AT · ATU (VAT)

ATU12345678

NL · KvK-nummer

KvK 12345678

CZ · Obchodní rejstřík

IČO 12345678

Initiate Institutional Access

We do not offer retail API trials. If your internal models require mathematically sound corporate intelligence, initiate a qualification call. Our deployment desk will configure the appropriate volumetric tier and issue your production keys.

Request Enterprise Access →Download OpenAPI Spec ↓

Response within 1 business day · All communications strictly confidential