Metadata-Version: 2.4
Name: cardinalapi
Version: 0.1.0
Summary: Official Python SDK for the Cardinal universal entity data API. Companies, officers, beneficial owners, court rulings, licenses, and sanctions across the EU.
Author: Cardinal Labs
License: MIT
Project-URL: Homepage, https://cardinal.dev
Project-URL: Documentation, https://cardinal.dev/docs
Project-URL: Source, https://github.com/cardinal-labs/cardinal-py
Keywords: cardinal,kyb,kyc,aml,sanctions,compliance,regtech,entity-resolution,beneficial-ownership
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27
Requires-Dist: pydantic>=2.7

# cardinal-py

Official Python SDK for the [Cardinal](https://cardinal.dev) universal entity
data API.

## Install

```bash
pip install cardinal-py
```

## Use

```python
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

```python
from cardinal_py import AsyncCardinal

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