CACS Decision Engine

API Reference

Endpoint

POST https://cacs-decision-api.onrender.com/api/v1/decision
Authorization: Bearer YOUR_API_KEY

Request Body

{
  "participant_id": "string — required",
  "org_id":         "string — required",
  "funding_amount": "number — required",
  "callback_url":   "string — optional webhook URL",
  "docs": {
    "photoId":     { "status": "verified | uploaded | pending | missing | expired | invalid" },
    "ssn":         { "status": "verified | uploaded | pending | missing | expired | invalid" },
    "birth":       { "status": "verified | uploaded | pending | missing | expired | invalid" },
    "cert":        { "status": "verified | uploaded | pending | missing | expired | invalid" },
    "eligibility": { "status": "verified | uploaded | pending | missing | expired | invalid" }
  }
}

Response Body

{
  "clearance_id":   "string — generated",
  "participant_id": "string",
  "org_id":         "string",
  "decision":       "CLEARED | BLOCKED | ACTION REQUIRED | PENDING",
  "reason":         "string",
  "consequence":    "string",
  "ownership":      "string",
  "funding_status": "released | locked | hold",
  "funding_amount": "number — 0 if not CLEARED",
  "requested_at":   "ISO timestamp",
  "decided_at":     "ISO timestamp"
}

Decision Rules

BLOCKED — photoId, ssn, or birth missing/invalid OR cert invalid. Funding locked.
ACTION REQUIRED — any document expired OR non-critical document missing. Funding locked.
PENDING — all documents present but not all verified. Funding on hold.
CLEARED — all documents verified, no flags. Funding released.

Authentication

Authorization: Bearer YOUR_API_KEY

Contact donceletta@getcacs.com to receive your API key.

Error Responses

401 Unauthorized — { "error": "Unauthorized" }
400 Bad Request  — missing required fields

Webhook Support

Include callback_url in your request. CACS will POST the full decision response to your endpoint after it is logged. No polling required.

View full onboarding guide →