CACS Decision Lane

5-Minute Quickstart (Postman)

1. Download the file: CACS_PILOT_POSTMAN.json (request via email below)
2. Open Postman → click Import → select the file
3. The collection "CACS Decision Lane — Pilot" appears with 3 requests
4. Set Postman environment variable: CACS_API_KEY = your API key
5. Open "Success (Cleared)" → click Send → expect decision: CLEARED
6. Open "Fail (Blocked)" → click Send → expect decision: BLOCKED
7. Open "Unauthorized (Wrong Key)" → click Send → expect 401

Endpoint

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

Authentication

Authorization: Bearer YOUR_API_KEY

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

Request Format

{
  "participant_id": "string",
  "org_id":         "string",
  "funding_amount": 4800,
  "docs": {
    "photoId":     { "status": "verified" },
    "ssn":         { "status": "verified" },
    "birth":       { "status": "verified" },
    "cert":        { "status": "verified" },
    "eligibility": { "status": "verified" }
  },
  "callback_url": "https://your-system.com/webhook"
}

Document Status Values

verified | uploaded | pending | missing | expired | invalid

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.

Node.js Example

const fetch = require('node-fetch');

async function runClearanceCheck(participantId, orgId, docs) {
  const response = await fetch(
    'https://cacs-decision-api.onrender.com/api/v1/decision',
    { method: 'POST',
      headers: { 'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_API_KEY' },
      body: JSON.stringify({ participant_id: participantId,
        org_id: orgId, funding_amount: 4800, docs }) });
  return await response.json();
}

Python Example

import requests

def run_clearance_check(participant_id, org_id, docs):
    response = requests.post(
        'https://cacs-decision-api.onrender.com/api/v1/decision',
        headers={ 'Authorization': 'Bearer YOUR_API_KEY' },
        json={ 'participant_id': participant_id,
               'org_id': org_id, 'funding_amount': 4800,
               'docs': docs })
    return response.json()

Security and Auditability

• Every request requires a Bearer token validated server-side
• Invalid or missing tokens return 401 Unauthorized immediately
• Every decision is permanently written to a PostgreSQL audit database
• Each clearance_id is unique and timestamped to the millisecond
• The audit log cannot be edited or deleted via the API

Support

Email: donceletta@getcacs.com
API Docs: getcacs.com/api-docs