Call67 Protect API

REST API for managing facility call screening, residents, and alerts.

Base URL: https://call67.app

Authentication

All facility API endpoints require an API key in the Authorization header:

Authorization: Bearer c67_your_api_key_here

Get your API key by starting a trial at /protect or contact [email protected].

Dashboard

GET /api/facilities/me/dashboard

Returns aggregated protection stats for your facility.

{
  "facility_id": "uuid",
  "facility_name": "Sunrise Senior Living",
  "total_residents": 75,
  "calls_screened": 142,
  "scams_blocked": 23,
  "deepfakes_found": 2,
  "alerts_this_week": 5,
  "high_risk_count": 3,
  "time_saved_mins": 34,
  "monthly_bill": "$950.00"
}

Residents

GET /api/facilities/me/residents

List all active residents in your facility.

[{
  "id": "uuid",
  "name": "Margaret Johnson",
  "phone": "+18185551234",
  "emergency_contact": "+13105559876",
  "risk_level": "medium",
  "active": true
}]

POST /api/facilities/me/residents

Add a new resident to protection.

Field	Type	Required	Description
name	string	Yes	Resident's full name
phone	string	Yes	Resident's phone number (E.164)
emergency_contact	string	No	Family/guardian phone number

Alerts

GET /api/facilities/me/alerts

Recent scam alerts for your facility (last 30 days, up to 100).

[{
  "id": "uuid",
  "resident_name": "Margaret Johnson",
  "caller_number": "+18005551234",
  "threat_type": "scam",
  "spam_score": 0.92,
  "action": "blocked",
  "details": "Extended warranty scam",
  "created_at": "2026-04-01T10:30:00Z"
}]

Threat types: scam, deepfake, robocall, suspicious

Actions: blocked, escalated, flagged

Family Reports

GET /api/residents/{id}/report

Public shareable protection report for a resident. No authentication required — share with family members.

Web view: https://call67.app/report/{resident_id}

Billing

POST /api/facilities/me/checkout

Start upgrade from trial to paid plan.

Field	Type	Description
plan	string	starter ($500/mo, ≤30 residents) or growth ($500 + $10/resident)

Demo

POST /api/demo/classify

Public endpoint — classify a call transcript. Rate limited to 5/min. No authentication.

Field	Type	Description
transcript	string	What the caller said

// Response
{
  "caller_name": "Mike",
  "organization": "State Farm",
  "purpose": "auto policy renewal",
  "category": "business",
  "spam_score": 0.0,
  "urgency": "low"
}

Rate Limits

Endpoint	Limit
Authenticated facility endpoints	No limit
/api/demo/classify	5 requests/min per IP
/api/facilities/trial	3 requests/hour per IP