Integrate HIPAA Compliance
Into Your Workflow via API

curl -X GET "https://hipaaagent.ai/v1/a2a/grade/1234567890" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json"

# Response
# "compliance_score" = HIPAA Agent Compliance Score™ (0-100)
# "grade" = HIPAA Agent Compliance Score™ letter grade (A-F)
{
  "npi": "1234567890",
  "practice_name": "Sacramento Family Dental",
  "compliance_score": 72,
  "grade": "C",
  "categories": {
    "email_security": { "score": 45, "weight": 35 },
    "application_security": { "score": 82, "weight": 13 },
    "privacy_compliance": { "score": 90, "weight": 10 }
  },
  "scan_date": "2026-02-28T09:14:34Z"
}

import requests

API_KEY = "your_api_key"
BASE = "https://hipaaagent.ai/v1/a2a"

# Dispatch a full compliance scan
resp = requests.post(
    f"{BASE}/scans/dispatch",
    headers={"X-API-Key": API_KEY},
    json={
        "npi": "1234567890",
        "scan_type": "full",
        "callback_url": "https://your-app.com/webhook"
    }
)

# 202 Accepted — async scan dispatched
data = resp.json()
# {
#   "status": "accepted",
#   "job_id": "job_7f3a9bc1d92e",
#   "poll_url": "/v1/a2a/jobs/job_7f3a9bc1d92e",
#   "estimated_duration_ms": 45000
# }

# Poll for completion
import time
while True:
    job = requests.get(
        f"{BASE}/../v1/a2a/jobs/{data['job_id']}",
        headers={"X-API-Key": API_KEY}
    ).json()
    if job["status"] == "completed":
        # grade = HIPAA Agent Compliance Score™ letter grade (A-F)
        print(f"Grade: {job['result']['grade']}")
        break
    time.sleep(5)

Webhooks: All async endpoints accept an optional callback_url. When the job completes, we POST the full result to your webhook endpoint.

const response = await fetch('https://hipaaagent.ai/v1/a2a/grade/1234567890', {
  headers: { 'X-API-Key': process.env.HIPAA_AGENT_API_KEY }
});
// compliance_score = HIPAA Agent Compliance Score™ (0-100)
// grade = HIPAA Agent Compliance Score™ letter grade (A-F)
const { grade, compliance_score, categories } = await response.json();
console.log(`Grade: ${grade} (${compliance_score}/100)`);

REST API

MCP Server

A2A Protocol

Agent Card

curl -X POST "https://hipaaagent.ai/api/a2a" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "hipaa.grade",
    "params": { "npi": "1234567890" },
    "id": 1
  }'

# Response
{
  "jsonrpc": "2.0",
  "result": {
    "npi": "1234567890",
    "grade": "C",
    "compliance_score": 72,
    "categories": { ... }
  },
  "id": 1
}