clearbound 0.1.0__tar.gz

clearbound-0.1.0/PKG-INFO

@@ -0,0 +1,62 @@
+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).

clearbound-0.1.0/README.md

@@ -0,0 +1,44 @@
+# 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).

clearbound-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "clearbound"
+version = "0.1.0"
+description = "Official Python SDK for the clearbound business verification & KYB API."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "Proprietary" }
+authors = [{ name = "clearbound" }]
+keywords = [
+  "kyb",
+  "business verification",
+  "beneficial ownership",
+  "sanctions screening",
+  "compliance",
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: Other/Proprietary License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Topic :: Office/Business :: Financial",
+]
+
+[project.urls]
+Homepage = "https://clearbound.xyz"
+Documentation = "https://clearbound.xyz/documentation.html"
+
+[project.scripts]
+clearbound = "clearbound._cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

clearbound-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

clearbound-0.1.0/src/clearbound/__init__.py

@@ -0,0 +1,21 @@
+"""Official Python SDK for the clearbound business verification & KYB API.
+
+https://clearbound.xyz
+"""
+
+from clearbound._client import Client
+from clearbound._errors import (
+    AuthenticationError,
+    ClearboundError,
+    PlanRequiredError,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "Client",
+    "ClearboundError",
+    "AuthenticationError",
+    "PlanRequiredError",
+    "__version__",
+]

clearbound-0.1.0/src/clearbound/_account.py

@@ -0,0 +1,11 @@
+from clearbound._errors import PlanRequiredError
+
+# Mirror of the server-side paid-plan entitlement. While the API is in private
+# preview this is a hard gate: no account has SDK access until its paid flag
+# is live, so every API-touching call refuses before any request is made.
+PAID_FEATURES_ENABLED = False
+
+
+def require_active_plan(feature: str) -> None:
+    if not PAID_FEATURES_ENABLED:
+        raise PlanRequiredError(feature)

clearbound-0.1.0/src/clearbound/_cli.py

@@ -0,0 +1,14 @@
+import sys
+
+import clearbound
+
+
+def main() -> int:
+    print(f"clearbound {clearbound.__version__}")
+    print("Python SDK for the clearbound business verification & KYB API.")
+    print("API access requires an active plan — https://clearbound.xyz")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

clearbound-0.1.0/src/clearbound/_client.py

@@ -0,0 +1,77 @@
+import os
+from typing import Optional, Sequence
+
+from clearbound import _account
+from clearbound._errors import AuthenticationError
+
+API_BASE = "https://api.clearbound.xyz/v1"
+
+_KEY_PREFIXES = ("sk_test_", "sk_live_")
+
+# Values accepted in Verifications.create(checks=...), per the API docs.
+CHECKS = ("registry", "ubo", "sanctions", "documents", "adverse_media")
+
+
+class Client:
+    """Client for the clearbound API (https://api.clearbound.xyz/v1).
+
+    Reads the API key from ``api_key`` or the ``CLEARBOUND_API_KEY``
+    environment variable. Keys are prefixed ``sk_test_`` (sandbox) or
+    ``sk_live_`` (billed).
+    """
+
+    def __init__(self, api_key: Optional[str] = None):
+        api_key = api_key or os.environ.get("CLEARBOUND_API_KEY")
+        if not api_key:
+            raise AuthenticationError(
+                "No API key provided. Pass api_key=... or set the "
+                "CLEARBOUND_API_KEY environment variable."
+            )
+        if not api_key.startswith(_KEY_PREFIXES):
+            raise AuthenticationError(
+                "Invalid API key: keys start with 'sk_test_' or 'sk_live_'."
+            )
+        self.api_key = api_key
+        self.verifications = Verifications(self)
+        self.monitoring = Monitoring(self)
+
+    @property
+    def is_live(self) -> bool:
+        return self.api_key.startswith("sk_live_")
+
+
+class Verifications:
+    """POST/GET /v1/verifications."""
+
+    def __init__(self, client: Client):
+        self._client = client
+
+    def create(
+        self,
+        legal_name: str,
+        registration_number: Optional[str] = None,
+        country: Optional[str] = None,
+        checks: Sequence[str] = ("registry",),
+        monitoring: bool = False,
+    ) -> dict:
+        _account.require_active_plan("Creating verifications")
+        raise NotImplementedError  # unreachable until the plan gate opens
+
+    def retrieve(self, verification_id: str) -> dict:
+        _account.require_active_plan("Retrieving verifications")
+        raise NotImplementedError
+
+
+class Monitoring:
+    """Continuous-monitoring enrolment and alerts."""
+
+    def __init__(self, client: Client):
+        self._client = client
+
+    def enroll(self, verification_id: str) -> dict:
+        _account.require_active_plan("Continuous monitoring")
+        raise NotImplementedError
+
+    def alerts(self) -> list:
+        _account.require_active_plan("Continuous monitoring")
+        raise NotImplementedError

clearbound-0.1.0/src/clearbound/_errors.py

@@ -0,0 +1,17 @@
+class ClearboundError(Exception):
+    """Base class for all clearbound SDK errors."""
+
+
+class AuthenticationError(ClearboundError):
+    """The API key is missing or malformed."""
+
+
+class PlanRequiredError(ClearboundError):
+    """The account does not have a plan with API access enabled."""
+
+    def __init__(self, feature: str):
+        super().__init__(
+            f"{feature} requires an active clearbound plan. API access is not "
+            "enabled for this account yet — visit https://clearbound.xyz to "
+            "activate a plan."
+        )

clearbound-0.1.0/src/clearbound.egg-info/PKG-INFO

@@ -0,0 +1,62 @@
+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).

clearbound-0.1.0/src/clearbound.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+src/clearbound/__init__.py
+src/clearbound/_account.py
+src/clearbound/_cli.py
+src/clearbound/_client.py
+src/clearbound/_errors.py
+src/clearbound.egg-info/PKG-INFO
+src/clearbound.egg-info/SOURCES.txt
+src/clearbound.egg-info/dependency_links.txt
+src/clearbound.egg-info/entry_points.txt
+src/clearbound.egg-info/top_level.txt

clearbound-0.1.0/src/clearbound.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

clearbound-0.1.0/src/clearbound.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+clearbound = clearbound._cli:main

clearbound-0.1.0/src/clearbound.egg-info/top_level.txt

@@ -0,0 +1 @@
+clearbound