Developers

Verification into your
workflow in a day.

Use the API and webhooks to run verifications from your case management system, or use the secure upload link with no integration at all. No SDK required.

Get an API keyTalk to our team

Quick start

cURL
# 1. Create a matter and get the upload link
curl -X POST https://api.immutis.com/v1/matters \
  -H "Authorization: Bearer <clerk_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "matter_ref": "MN-2026-0418",
    "party_name": "Jane Smith",
    "sort_code": "04-00-00",
    "account_number": "12345678",
    "documents": ["payslip", "proof_of_funds", "id"]
  }'

# 2. Run the checks
curl -X POST https://api.immutis.com/v1/matters/mat_1842/run \
  -H "Authorization: Bearer <clerk_token>"

# 3. Get the signed report
curl -X GET https://api.immutis.com/v1/matters/mat_1842 \
  -H "Authorization: Bearer <clerk_token>"

API Reference

POST/v1/matters

Create a matter and get a secure upload link for the party's documents.

Parameters

NameTypeRequiredDescription
matter_refstringYesYour firm's reference for the matter
party_namestringYesThe seller or buyer being verified
sort_codestringYesReceiving account sort code
account_numberstringYesReceiving account number
documentsstring[]NoDocument types expected, e.g. payslip, proof_of_funds, id

Response

{
  "matter_id": "mat_1842",
  "upload_url": "https://api.immutis.com/v1/matters/mat_1842/upload",
  "status": "awaiting_documents",
  "created_at": 1783945928000
}
POST/v1/matters/{id}/run

Trigger the verification run: bank check, document forensics, identity screen, and the confirmation call.

Parameters

NameTypeRequiredDescription
idstringYesThe matter ID

Response

{
  "matter_id": "mat_1842",
  "checks": {
    "bank_account": "pending",
    "documents": "pending",
    "identity": "pending",
    "confirmation_call": "queued"
  },
  "status": "in_progress"
}
GET/v1/matters/{id}

Retrieve the matter and the result of every check.

Parameters

NameTypeRequiredDescription
idstringYesThe matter ID

Response

{
  "matter_id": "mat_1842",
  "matter_ref": "MN-2026-0418",
  "party_name": "Jane Smith",
  "bank_account": { "status": "pass", "account_holder": "J Smith" },
  "documents": { "status": "pass", "findings": [] },
  "identity": { "status": "pass", "ai_generation": "not_detected" },
  "confirmation_call": { "status": "recorded", "recorded_at": 1783947000000 },
  "report_id": "rpt_2026_0418"
}
GET/public/verify/{report_id}

Open, unauthenticated verification of a signed report. No account required.

Parameters

NameTypeRequiredDescription
report_idstringYesThe signed report ID

Response

{
  "verified": true,
  "data": { "report_id": "rpt_2026_0418", "verification_status": "verified", ... },
  "issuer": "https://api.immutis.com"
}

Webhooks

Receive real-time notifications when a matter completes, is flagged, or needs review.

POST /your-webhook-endpoint

{
  "event": "matter.completed",
  "matter_id": "mat_1842",
  "matter_ref": "MN-2026-0418",
  "report_id": "rpt_2026_0418",
  "result": {
    "status": "pass",
    "bank_account": "pass",
    "documents": "pass",
    "identity": "pass",
    "confirmation_call": "recorded"
  }
}

Ready to integrate?

Run your first matter from submit to signed report. No setup fee.

Get API key