Clients

The two top-level entry points. Construct one per API key and reuse it for the lifetime of your process — both classes hold an httpx connection pool and a rate limiter that need to live across requests.

ComplianceClient

ComplianceClient

Synchronous client for the Anthropic Compliance API.

Construct a single client per API key and reuse it across calls. The client holds a connection pool and a rate limiter, both of which need to live across requests for full benefit.

Parameters:

Name	Type	Description	Default
api_key	str | None	A Compliance Access Key (sk-ant-api01-...) or an Admin key (sk-ant-admin01-...). If omitted, the value of the ANTHROPIC_COMPLIANCE_API_KEY environment variable is used.	None
base_url	str	Override the API host. Defaults to the Anthropic production host. Useful for testing against a recorded fixture server.	DEFAULT_BASE_URL
timeout	float	Per-request timeout in seconds. Default 30.	DEFAULT_TIMEOUT_SECONDS
max_download_bytes	int	Maximum size, in bytes, that the eager download() methods will load into memory. Larger files must be fetched through download_to_file() or download_stream(). Default 100 MiB.	DEFAULT_MAX_DOWNLOAD_BYTES
max_retries	int	Maximum retry attempts for 429 and 5xx responses. Default 3. Set to 0 to disable retries.	DEFAULT_MAX_RETRIES
rate_limit_rpm	int	Proactive client-side requests-per-minute cap. Defaults to 600. This is best-effort and per-client: it only smooths bursts from this client instance. The live API enforces 600 RPM per parent organisation, shared across every key and every /v1/compliance/* endpoint — a budget this limiter cannot see. If you run multiple clients under the same parent, set this to 600 / n_clients to avoid collectively exceeding it, or set it to 0 to disable and rely on server-side 429 handling.	DEFAULT_RATE_LIMIT_RPM

Raises:

Type	Description
ValueError	If no API key is supplied through api_key or the environment variable.

Example

from claude_compliance_sdk import ComplianceClient

with ComplianceClient(api_key="sk-ant-api01-...") as client:
    for activity in client.activities.iter(limit=10):
        print(activity.id, activity.type)

close

close() -> None

Close the underlying HTTP connection pool.

Safe to call multiple times. After close() is invoked, the client must not be reused.

AsyncComplianceClient

AsyncComplianceClient

Asynchronous client for the Anthropic Compliance API.

Construct a single client per API key and reuse it across awaits. Designed to be used as an async context manager so the underlying httpx.AsyncClient is closed cleanly on exit.

Parameters:

Name	Type	Description	Default
api_key	str | None	A Compliance Access Key (sk-ant-api01-...) or an Admin key (sk-ant-admin01-...). If omitted, the value of the ANTHROPIC_COMPLIANCE_API_KEY environment variable is used.	None
base_url	str	Override the API host. Defaults to the Anthropic production host.	DEFAULT_BASE_URL
timeout	float	Per-request timeout in seconds. Default 30.	DEFAULT_TIMEOUT_SECONDS
max_download_bytes	int	Maximum size, in bytes, that the eager download() coroutines will load into memory. Larger files must be fetched through download_to_file() or download_stream(). Default 100 MiB.	DEFAULT_MAX_DOWNLOAD_BYTES
max_retries	int	Maximum retry attempts for 429 and 5xx responses. Default 3. Set to 0 to disable retries.	DEFAULT_MAX_RETRIES
rate_limit_rpm	int	Proactive client-side requests-per-minute cap. Defaults to 600. This is best-effort and per-client: it only smooths bursts from this client instance. The live API enforces 600 RPM per parent organisation, shared across every key and every /v1/compliance/* endpoint — a budget this limiter cannot see. If you run multiple clients under the same parent, set this to 600 / n_clients to avoid collectively exceeding it, or set it to 0 to disable and rely on server-side 429 handling.	DEFAULT_RATE_LIMIT_RPM

Raises:

Type	Description
ValueError	If no API key is supplied through api_key or the environment variable.

Example

import asyncio

from claude_compliance_sdk import AsyncComplianceClient


async def main() -> None:
    async with AsyncComplianceClient(api_key="sk-ant-api01-...") as client:
        async for activity in client.activities.iter(limit=10):
            print(activity.id, activity.type)


asyncio.run(main())

aclose async

aclose() -> None

Close the underlying async HTTP connection pool.

Safe to await multiple times. After aclose() is awaited, the client must not be reused.