cardinalapi 0.1.0

Official Python SDK for the Cardinal universal entity data API. Companies, officers, beneficial owners, court rulings, licenses, and sanctions across the EU.

cardinal-py

Official Python SDK for the Cardinal universal entity data API.

Install

pip install cardinal-py

Use

from cardinal_py import Cardinal

cardinal = Cardinal(api_key="cardinal_live_...")

# Search
hits = cardinal.search(country="no", status="in_bankruptcy", limit=10)
for entity in hits.results:
    print(entity.legal_name, entity.cardinal_id)

# Lookup by registry id
[entity] = cardinal.lookup(country="no", registry_id="932102285")
print(entity.status, entity.risk_score)

# AI risk summary
summary = cardinal.risk_summary(entity.cardinal_id)
print(summary.risk_score, summary.ai_summary)

# Natural-language query
answer = cardinal.query("German construction companies in insolvency since March 2026")
print(answer.summary)
for r in answer.results:
    print(r["legal_name"])

Async

from cardinal_py import AsyncCardinal

async with AsyncCardinal(api_key=...) as c:
    hits = await c.search(q="ABACUS")