Reconify Python SDK

Typed synchronous and asynchronous clients for the public Reconify v2 API.

Installation and quickstart

pip install reconify-python

from reconify import Reconify

with Reconify(api_key="rk_...") as client:
    events = client.events.list_events(limit=25)
    for event in events.events:
        print(event.id, event.status)

The API key may also come from RECONIFY_API_KEY. The default endpoint is https://api.reconifyhq.com/v2. RECONIFY_API_URL or base_url can select a staging or self-hosted endpoint, and URLs with or without /v2 are accepted.

Public resources

The client exposes metadata, events, ingestion, issues, organization, and on-chain evidence registration. The current public contract contains exactly 14 operations. Python methods use snake_case names and typed Pydantic v2 models from reconify.models.

Sync and async clients provide cursor iterators:

from reconify import AsyncReconify

async with AsyncReconify() as client:
    async for event in client.iter_events(limit=100):
        print(event.id)

Every operation supports raw=True for RawResponse and per-request timeout through the timeout keyword. API errors expose status, detail, code, validation details, response headers, and request ID without including keys or request bodies. Safe methods retry bounded 429, 503, and transport failures by default; unsafe retries require RetryConfig(retry_unsafe_methods=True).

Contract synchronization

python scripts/fetch_contract.py
python scripts/fetch_contract.py --latest
pytest -q tests/test_openapi_coverage.py

The default source is the public manifest at https://docs.reconifyhq.com/openapi/manifest.json. For local SaaS changes, set RECONIFY_OPENAPI_SPEC to an explicit OpenAPI JSON file. The SDK never depends on another checkout or an absolute workspace path.

Migration to 2.0.0

Version 2.0.0 targets the v2 monitoring and issue-investigation API at /v2. Generated operation IDs use stable resource_action identifiers while the Python resource methods retain their snake_case names. See UPGRADING.md.

Version 2.2.0 adds settlement event fields, flexible ingestion payloads, and on-chain evidence source registration. See UPGRADING.md.

Build and release

ruff check .
mypy src
pytest -q
python -m build

The release workflow publishes the built wheel to PyPI after a GitHub release. Additive contract changes require a minor SDK release; SDK fixes require a patch release; breaking public API changes require a new API version and SDK major release.