Audit

16 curated, deterministic Audit Hub tools spanning External Audit, Internal Audit, Islamic Finance, and Company Secretary work. These never call the underlying model, so they're free to run.

Internally wraps: New deterministic dispatcher over a curated Audit Hub tool subset

POST/v1/audit/analyzeGA

Audit Hub analysis (16 curated, deterministic tools)

Runs one of 16 curated, fully-deterministic Audit Hub tools (External Audit, Internal Audit, Islamic Finance, and Company Secretary work). `tool_type` plus tool-specific fields select the check; this endpoint never calls the underlying model, so it never costs credits.

Required scope: audit~0 credit(s)/callSDK: audit.analyze(...)

tool_type is one of: risk, materiality, program, going_concern, opinion, ia_charter, ia_qaip, ia_payroll_fn, ia_it_audit, ubo_compliance, agm_planner, murabaha, zakat, complete_audit, performance_audit, procurement_audit.
Fields beyond tool_type/jurisdiction are tool-specific — see GET /v1/audit/tools for the full catalogue.
Deterministic: credits_used is always 0 and no Anthropic call is made.

Request body

{
  "tool_type": "ia_payroll_fn",
  "jurisdiction": "AE",
  "entity_name": "Acme Manufacturing LLC",
  "period": "2025-Q1"
}

Response body

{
  "id": "req_...",
  "tool_type": "ia_payroll_fn",
  "jurisdiction": "AE",
  "result": {
    "findings": [
      "Payroll approval and disbursement are not segregated for 3 of 12 sampled pay runs."
    ],
    "risk_rating": "medium"
  },
  "credits_used": 0,
  "warnings": [],
  "disclaimer": "This response is generated by an AI legal assistant for informational purposes only and does not constitute legal advice. Consult a qualified legal professional before relying on it."
}

POST /v1/audit/analyze

curl -X POST https://cailegal-backend-production-7edb.up.railway.app/v1/audit/analyze \
  -H "Authorization: Bearer cai_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "tool_type": "ia_payroll_fn",
  "jurisdiction": "AE",
  "entity_name": "Acme Manufacturing LLC",
  "period": "2025-Q1"
}'

GET/v1/audit/toolsGA

List the 16 curated Audit Hub tools

Returns the catalogue of `tool_type` values accepted by `/v1/audit/analyze`.

Required scope: audit~0 credit(s)/callSDK: audit.tools.list(...)

Request body

{}

Response body

{
  "tools": [
    {
      "tool_type": "risk"
    },
    {
      "tool_type": "materiality"
    },
    {
      "tool_type": "program"
    },
    {
      "tool_type": "going_concern"
    },
    {
      "tool_type": "opinion"
    },
    {
      "tool_type": "ia_charter"
    },
    {
      "tool_type": "ia_qaip"
    },
    {
      "tool_type": "ia_payroll_fn"
    },
    {
      "tool_type": "ia_it_audit"
    },
    {
      "tool_type": "ubo_compliance"
    },
    {
      "tool_type": "agm_planner"
    },
    {
      "tool_type": "murabaha"
    },
    {
      "tool_type": "zakat"
    },
    {
      "tool_type": "complete_audit"
    },
    {
      "tool_type": "performance_audit"
    },
    {
      "tool_type": "procurement_audit"
    }
  ]
}

GET /v1/audit/tools

curl -X GET https://cailegal-backend-production-7edb.up.railway.app/v1/audit/tools \
  -H "Authorization: Bearer cai_live_YOUR_KEY"