API Reference

Overview

The Protectron API allows you to programmatically interact with your compliance data. Use it to:

• Submit events from custom integrations
• Query audit trail data
• Generate compliance reports
• Manage AI systems and configurations
• Set up webhooks for real-time notifications

Rate Limits

Rate limit headers are included in every response:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 299
X-RateLimit-Reset: 1702742400

Endpoints

Code Examples

Python

import requests

API_KEY = "pk_live_xxx"
BASE_URL = "https://api.protectron.ai/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# List systems
response = requests.get(f"{BASE_URL}/systems", headers=headers)
systems = response.json()["data"]

# Create event
event = {
    "system_id": "sys_abc123",
    "event_type": "llm_call",
    "data": {
        "model": "gpt-5.2",
        "input": [{"role": "user", "content": "Hello"}],
        "output": "Hi there!",
        "tokens_input": 5,
        "tokens_output": 3
    }
}
response = requests.post(f"{BASE_URL}/events", json=event, headers=headers)

TypeScript

const API_KEY = 'pk_live_xxx';
const BASE_URL = 'https://api.protectron.ai/v1';

async function listSystems() {
  const response = await fetch(`${BASE_URL}/systems`, {
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
    },
  });
  return response.json();
}

async function createEvent(event: object) {
  const response = await fetch(`${BASE_URL}/events`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(event),
  });
  return response.json();
}

cURL

# List systems
curl https://api.protectron.ai/v1/systems \
  -H "Authorization: Bearer pk_live_xxx"

# Create event
curl https://api.protectron.ai/v1/events \
  -X POST \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "system_id": "sys_abc123",
    "event_type": "llm_call",
    "data": {
      "model": "gpt-5.2",
      "tokens_input": 5,
      "tokens_output": 3
    }
  }'