> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parmanasystems.com/llms.txt
> Use this file to discover all available pages before exploring further.

# parmana.client

Parmana Client.

Main entry point for the Parmana Python SDK.

## ParmanaClient Objects

```python theme={null}
class ParmanaClient()
```

Parmana SDK Client.

Parmana ensures AI executes only policy-compliant actions.

## Example

> > > client = ParmanaClient(
> > > ... endpoint="[http://localhost:3000](http://localhost:3000)",
> > > ... )

> > > trust\_record = client.execution.execute(transaction)

> > > verification = client.verification.verify(
> > > ... transaction.business\_transaction\_id,
> > > ... )

#### \_\_init\_\_

```python theme={null}
def __init__(*,
             endpoint: str,
             api_key: str | None = None,
             timeout: int = DEFAULT_TIMEOUT,
             max_retries: int = DEFAULT_MAX_RETRIES,
             backoff_factor: float = DEFAULT_BACKOFF_FACTOR,
             debug: bool = False) -> None
```

Create a Parmana SDK client.

## Raises

ConfigurationError:
If `endpoint` is missing or empty. Mirrors
typescript/src/client/ParmanaClient.ts's identical
fail-fast check.

This client is synchronous only. There is no async variant.

## Parameters

endpoint:
Base URL of the Parmana Runtime.

api\_key:
Caller bearer key, minted by scripts/generate-api-key.ts. Sent
as `Authorization: Bearer <api_key>` on every request. Omit
only against a Runtime started with PARMANA\_AUTH\_DISABLED=true
(local development only); every other deployment rejects an
unauthenticated request with a 401 before a Business
Transaction is even constructed. See
/api-reference/authentication.

timeout:
HTTP timeout in seconds, applied per request.

max\_retries:
Retry attempts for idempotent (GET) requests that fail with
a connection error or a 502/503/504 response. POST requests
(execute, verify, receipt, replay) are never retried.

backoff\_factor:
Exponential backoff factor between retries, in seconds.

debug:
Enable request/response debug logging on the "parmana" logger.

#### endpoint

```python theme={null}
@property
def endpoint() -> str
```

Parmana Runtime endpoint.

#### version

```python theme={null}
@property
def version() -> str
```

Parmana SDK version.

#### health

```python theme={null}
def health() -> dict[str, Any]
```

Returns the Runtime health status.

#### execute

```python theme={null}
def execute(transaction: BusinessTransaction) -> ExecutionTrustRecord
```

Execute a Business Transaction.

#### verify

```python theme={null}
def verify(business_transaction_id: str) -> Verification
```

Run a fresh verification of an Execution Trust Record, appending
a new Verification to its history. Distinct from
get\_latest\_verification(), which reads the most recent one
without re-verifying.

#### get\_latest\_verification

```python theme={null}
def get_latest_verification(business_transaction_id: str) -> Verification
```

Returns the latest Verification, without performing a fresh one.

#### create\_transaction

```python theme={null}
def create_transaction(
        transaction: BusinessTransaction) -> ExecutionTrustRecord
```

Creates (executes) a Business Transaction via POST /transactions,
a second, independent entry point into the identical execution
pipeline as execute() (POST /execute).

#### transaction

```python theme={null}
def transaction(business_transaction_id: str) -> BusinessTransaction
```

Retrieves a Business Transaction.

#### trust\_record

```python theme={null}
def trust_record(business_transaction_id: str) -> ExecutionTrustRecord
```

Retrieves an Execution Trust Record.

#### validate\_policy

```python theme={null}
def validate_policy(policy_id: str, policy_version: str) -> dict[str, Any]
```

Validates that a policy (name + version) is loadable.

#### refusal\_record

```python theme={null}
def refusal_record(business_transaction_id: str) -> RefusalRecord
```

Retrieves a Refusal Record by Business Transaction ID.

#### verify\_refusal\_record

```python theme={null}
def verify_refusal_record(record: RefusalRecord) -> bool
```

Verifies a Refusal Record's signature.

#### verify\_audit\_event

```python theme={null}
def verify_audit_event(event: dict[str, Any], signature: Signature) -> bool
```

Verifies a signed caller-authentication or Razorpay-webhook
audit event's signature.