Metadata-Version: 2.4
Name: clearbound
Version: 0.1.0
Summary: Official Python SDK for the clearbound business verification & KYB API.
Author: clearbound
License: Proprietary
Project-URL: Homepage, https://clearbound.xyz
Project-URL: Documentation, https://clearbound.xyz/documentation.html
Keywords: kyb,business verification,beneficial ownership,sanctions screening,compliance
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# clearbound

Official Python SDK for the [clearbound](https://clearbound.xyz) business
verification & KYB API: registry checks, beneficial ownership (UBO), sanctions
and PEP screening, document review, and continuous monitoring — one API, one
auditable decision.

## Installation

```bash
pip install clearbound
```

Requires Python 3.9+. No third-party dependencies.

## Usage

```python
import clearbound

client = clearbound.Client(api_key="sk_test_...")  # or set CLEARBOUND_API_KEY

verification = client.verifications.create(
    legal_name="Northwind Ventures LLC",
    registration_number="DE-7421199",
    country="US",
    checks=["registry", "ubo", "sanctions", "documents"],
)
```

## Plan required

API access is available on paid clearbound plans. Until a plan is active on
your account, every API call raises `clearbound.PlanRequiredError`:

```python
try:
    client.verifications.create(legal_name="Northwind Ventures LLC")
except clearbound.PlanRequiredError as err:
    print(err)  # Creating verifications requires an active clearbound plan...
```

Visit [clearbound.xyz](https://clearbound.xyz) to activate a plan, or see the
[API documentation](https://clearbound.xyz/documentation.html).
