Detect perimeter-breach signals API

Analyze caller-supplied perimeter sensor events for possible breaches. Multi-sensor alarms raise confidence; still not a confirmed physical breach.

The Detect perimeter-breach signals operation is part of the Physical & IoT Security API on BRAINIAC.software. Analyze caller-supplied perimeter sensor events for possible breaches. Multi-sensor alarms raise confidence; still not a confirmed physical breach. It is exposed as POST /api/v1/physical-security/perimeter-breach-signal-detect and priced at $0.04 USDC on Base. Payment uses the x402 exact scheme: an unpaid call returns HTTP 402 with payment requirements; after paying the exact USDC amount, retry the same request with a payment-signature header and Idempotency-Key. No account and no API key are required. Data sources for this product: Caller-supplied physical/IoT event logs and telemetry processed locally Limitations: Physical security systems are not contacted and devices are never controlled. Anomalies are not labeled confirmed physical incidents without sufficient multi-signal evidence. Temporal correlation and anomaly rules run locally over supplied records only. Missing telemetry values are reported as missing, not invented. No paid physical-security feed is used and no API key is required. Outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Related operations in this group include Detect sensor-event anomalies, Detect unusual door-access patterns, Detect tailgating signals, Detect camera-tampering signals. Open the group documentation for the full request schema, field notes, and response examples before integrating.

POST$0.04 USDC
/api/v1/physical-security/perimeter-breach-signal-detect

Example request

curl -i -X POST "https://www.brainiac.software/api/v1/physical-security/perimeter-breach-signal-detect" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "events": [
    {
      "id": "P1",
      "at": "2026-11-04T20:10:00.000Z",
      "category": "perimeter",
      "zone": "north-fence",
      "deviceId": "beam-1",
      "eventType": "intrusion_alarm",
      "outcome": "alarm",
      "severity": "high",
      "message": "beam trip",
      "source": "Caller-supplied"
    },
    {
      "id": "P2",
      "at": "2026-11-04T20:10:20.000Z",
      "category": "perimeter",
      "zone": "north-fence",
      "deviceId": "pir-2",
      "eventType": "intrusion_alarm",
      "outcome": "alarm",
      "severity": "high",
      "message": "climb suspected",
      "labels": [
        "breach"
      ],
      "source": "Caller-supplied"
    }
  ]
}
JSON

An unpaid probe returns HTTP 402 with x402 payment requirements. After paying the exact USDC amount on Base, retry the identical request with a payment-signature header.

FAQ

  • Do I need an API key? No. Pay the listed USDC amount with x402.
  • What network? Base (eip155:8453), USDC.
  • Is this an official determination? No. Results are for human review against the cited sources.

Related APIs

Physical & IoT Security APIFull docsHow it works