KYB checks as an API.

Sign up and create an API key in Settings. Your first call is free, no card needed.

curl -X POST https://api.getsonar.report/v1/agents/kyb-diligence/findings \
  -H "X-API-Key: sk-sonar-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"company_name": "Tesco PLC", "website": "https://www.tesco.com"}'

{
  "request_id": "req_abc123",
  "agent": "kyb-diligence",
  "company": { "name": "Tesco PLC", "domain": "tesco.com" },
  "status": "completed",
  "fields": {
    "corporate_registration": {
      "findings": [{
        "value": "TESCO PLC, company no. 00445790, Active, incorporated 27 Nov 1947",
        "confidence": "HIGH",
        "sources": [{
          "provider": "Companies House",
          "url": "https://find-and-update.company-information.service.gov.uk/company/00445790",
          "excerpt": "Name: TESCO PLC. Reg No: 00445790. Status: Active...",
          "retrieved_at": "2026-10-18T09:00:44Z"
        }]
      }],
      "confidence": "HIGH",
      "confidence_score": 0.92
    },
    "sanctions_screening": {
      "findings": [{
        "value": "No matches across 8 sanctions lists",
        "confidence": "MEDIUM",
        "sources": [{ "provider": "Sanctions Lists", "url": "" }]
      }],
      "confidence": "MEDIUM",
      "confidence_score": 0.65
    }
  },
  "sources_checked": 23,
  "fields_found": ["corporate_registration", "directors_officers", "adverse_media", ...],
  "fields_not_found": ["ownership_structure"],
  "processing_time_ms": 42150
}

Python

import requests

response = requests.post(
    "https://api.getsonar.report/v1/agents/kyb-diligence/findings",
    headers={
        "X-API-Key": "sk-sonar-your-key-here",
        "Content-Type": "application/json",
    },
    json={
        "company_name": "Wirecard AG",
        "website": "wirecard.com",
    },
)

data = response.json()

# Check sanctions screening
sanctions = data["fields"]["sanctions_screening"]
if sanctions["confidence"] == "HIGH":
    print(f"ALERT: {len(sanctions['findings'])} sanctions flags found")

# Check overall risk
for field_name, field_data in data["fields"].items():
    if field_data["findings"]:
        print(f"{field_name}: {field_data['confidence']} confidence")

JavaScript / Node.js

const response = await fetch(
  "https://api.getsonar.report/v1/agents/adverse-media/findings",
  {
    method: "POST",
    headers: {
      "X-API-Key": "sk-sonar-your-key-here",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      company_name: "Acme Corp",
    }),
  }
);

const data = await response.json();

// Filter high-confidence findings only
const highConfidence = Object.entries(data.fields)
  .filter(([_, field]) => field.confidence === "HIGH")
  .flatMap(([_, field]) => field.findings);

console.log(`Found ${highConfidence.length} high-confidence findings`);

Async Report (curl)

# 1. Submit the run
curl -X POST https://api.getsonar.report/v1/agents/kyb-diligence/run \
  -H "X-API-Key: sk-sonar-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"company_name": "Tesco PLC", "website": "https://www.tesco.com"}'

# Response: {"run_id": "abc123", "status": "pending", "poll_url": "/v1/agents/..."}

# 2. Poll for results
curl https://api.getsonar.report/v1/agents/kyb-diligence/run/abc123 \
  -H "X-API-Key: sk-sonar-your-key-here"

# Response when complete: {"status": "completed", "result": {...}, "report": {...}}

LangChain — wrap as a tool

from langchain_core.tools import tool
import requests

SONAR_KEY = "sk-sonar-your-key-here"

@tool
def kyb_screen(company_name: str, website: str = "") -> dict:
    """Run a KYB compliance screening on a company.
    Returns sanctions, FCA registration, directors, UBOs, adverse media."""
    r = requests.post(
        "https://api.getsonar.report/v1/agents/kyb-diligence/findings",
        headers={"X-API-Key": SONAR_KEY},
        json={"company_name": company_name, "website": website},
        timeout=120,
    )
    return r.json()

# Now bind to your agent (works with any LangChain LLM):
from langchain_anthropic import ChatAnthropic
llm = ChatAnthropic(model="claude-sonnet-5-5").bind_tools([kyb_screen])
response = llm.invoke("Run a KYB check on Tesco PLC and tell me what's risky.")

Anthropic Python SDK — native tool use

from anthropic import Anthropic
import requests

SONAR_KEY = "sk-sonar-your-key-here"

client = Anthropic()
response = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=16000,
    tools=[{
        "name": "kyb_screen",
        "description": "KYB compliance screening: sanctions, FCA, directors, UBOs, adverse media.",
        "input_schema": {
            "type": "object",
            "properties": {
                "company_name": {"type": "string"},
                "website": {"type": "string"},
            },
            "required": ["company_name"],
        },
    }],
    messages=[{"role": "user", "content": "Screen Tesco PLC."}],
)

# When Claude calls the tool, dispatch to SONAR:
for block in response.content:
    if block.type == "tool_use" and block.name == "kyb_screen":
        result = requests.post(
            "https://api.getsonar.report/v1/agents/kyb-diligence/findings",
            headers={"X-API-Key": SONAR_KEY},
            json=block.input,
        ).json()
        # ...continue the conversation with the result