Run a Pre-Submission Soft Check

Quick pass/fail check before submitting a case to the network.

What you'll do

• 1
  Upload a fact find document for a residential mortgage case
• 2
  Run a soft check — lighter and faster than a full compliance review
• 3
  Get a quick pass/fail result across three core checks
• 4
  Fix any issues before submitting the case to your compliance officer

The API call

Submit the fact find with depth="soft_check" for a fast pass/fail result.

from curvestone import Agent

agent = Agent()  # reads CURVESTONE_API_KEY from env

result = agent.check(
    case_type="residential_mortgage",
    depth="soft_check",
    documents=[
        open("fact_find.pdf", "rb"),
    ],
    reference="PRE-2026-00112",
)

print(f"Triage: {result.triage}")        # pass | fail
print(f"Checks: {len(result.checks)}")   # 3
print(f"Time:   {result.processing_time}")
print(f"Cost:   {result.cost}")

The response

A compact pass/fail result. No RAG scoring — just a binary outcome per check.

1{
2  "id": "job_4pLm6nRsW8",
3  "type": "check",
4  "status": "completed",
5  "triage": "pass",
6  "reference": "PRE-2026-00112",
7  "processing_time": "32s",
8  "scoring": "pass_fail",
9  "checks": [
10    { "name": "Document Completeness", "triage": "pass" },
11    { "name": "Income Declared",       "triage": "pass" },
12    { "name": "Product Suitability",   "triage": "pass" }
13  ],
14  "findings": [],
15  "cost": "£0.50"
16}

What happens