{"uid":"cap_aMhll6ReK8Y45yFdLH4j9","slug":"brainiac-physical-security-alarm-correlation-analyzer-2b5d1a7f","name":"BRAINIAC Physical Security Alarm Correlation Analyzer","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/physical-security/alarm-correlation-analyze?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000},"asOf":{"type":"string","maxLength":40},"file":{"type":"object","required":["fileBase64"],"properties":{"role":{"type":"string","maxLength":80},"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json","application/octet-stream"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"json":{"type":"string","maxLength":200000},"text":{"type":"string","maxLength":200000},"files":{"type":"array","items":{"type":"object","required":["fileBase64"],"properties":{"role":{"type":"string","maxLength":80},"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json","application/octet-stream"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"maxItems":20},"events":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"zone":{"type":"string","maxLength":120},"value":{"type":"number","maximum":1000000000,"minimum":-1000000000},"doorId":{"type":"string","maxLength":120},"labels":{"type":"array","items":{"type":"string","maxLength":80},"maxItems":40},"source":{"type":"string","maxLength":200},"userId":{"type":"string","maxLength":120},"badgeId":{"type":"string","maxLength":120},"message":{"type":"string","maxLength":4000},"outcome":{"enum":["granted","denied","forced","held","alarm","clear","unknown"],"type":"string"},"baseline":{"type":"number","maximum":1000000000,"minimum":-1000000000},"building":{"type":"string","maxLength":120},"cameraId":{"type":"string","maxLength":120},"category":{"enum":["sensor","door","perimeter","camera","alarm","iot","access","other"],"type":"string"},"deviceId":{"type":"string","maxLength":120},"severity":{"type":"string","maxLength":40},"direction":{"enum":["in","out","unknown"],"type":"string"},"eventType":{"type":"string","maxLength":120},"threshold":{"type":"number","maximum":1000000000,"minimum":-1000000000},"deviceType":{"type":"string","maxLength":80},"relatedEventIds":{"type":"array","items":{"type":"string","maxLength":80},"maxItems":100}},"additionalProperties":false},"maxItems":20000},"anomalyStdev":{"type":"number","maximum":10,"minimum":1},"offlineMinutes":{"type":"number","maximum":10080,"minimum":1},"tailgateSeconds":{"type":"number","maximum":600,"minimum":1},"doorWindowMinutes":{"type":"number","maximum":10080,"minimum":1},"correlationWindowMinutes":{"type":"number","maximum":1440,"minimum":1}}},"responseSchema":{"type":"json","example":{"items":[{"id":"alarm-corr-A1","title":"Correlated multi-sensor alarms","lastAt":"2026-11-04T20:02:00.000Z","source":"Caller-supplied alarms; local time-window correlation","status":"signal","firstAt":"2026-11-04T20:00:00.000Z","reasons":["multi_device_alarms","cross_category_alarms"],"detector":"alarm-correlation-analyze","evidence":[{"at":"2026-11-04T20:00:00.000Z","fact":"intrusion_alarm; device=panel-1; zone=lobby; outcome=alarm","eventId":"A1","inference":"Correlation groups alarms; does not confirm a physical incident.","confidence":"medium"},{"at":"2026-11-04T20:01:00.000Z","fact":"forced_open; device=door-lobby; zone=lobby; outcome=forced","eventId":"A2","inference":"Correlation groups alarms; does not confirm a physical incident.","confidence":"medium"},{"at":"2026-11-04T20:02:00.000Z","fact":"motion_alarm; camera=cam-lobby; outcome=alarm","eventId":"A3","inference":"Correlation groups alarms; does not confirm a physical incident.","confidence":"medium"}],"confidence":"high","observedFacts":["3 alarm-severity events within 15 minutes.","Alarms across devices: panel-1, door-lobby, cam-lobby.","Categories involved: alarm, door, camera."],"inferredThreat":"Temporally clustered alarms may represent one incident spanning sensors.","relatedEventIds":["A1","A2","A3"],"confirmedIncident":false}],"status":"detected","findings":[{"code":"alarm_correlation","kind":"conflict","detail":"Correlated alarms via multi_device_alarms, cross_category_alarms (confirmedIncident=false).","subject":"A1"}],"checkedAt":"2026-11-04T21:00:00.000Z","itemCount":1,"limitations":["Physical/IoT event logs and telemetry are copied only from caller-supplied fields. Physical security systems are not contacted and devices are never controlled.","Temporal correlation and anomaly rules run locally over supplied records. Missing values are not invented.","Observed facts are separated from inferred threat hypotheses. Anomalies are not labeled confirmed physical incidents without sufficient multi-signal evidence.","Configurable windows/thresholds apply only when supplied; otherwise documented defaults are used.","No paid physical-security feed is used and no API key is required."],"windowMinutes":15,"apiKeyRequired":false,"networkAccessed":false,"deviceControlled":false,"paidProviderUsed":false,"physicalSystemConnected":false,"confirmedIncidentClaimed":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PZSd1ZKkDAWPCJlOd7D3P","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Correlates physical security alarm events across multiple sensors, doors, cameras, and devices to identify temporally clustered incidents and potential threats.","exampleAgentPrompt":"I have a log of physical security events from last night — door forced-open on lobby at 20:00, intrusion alarm from panel-1 at 20:00, and a motion alarm from cam-lobby at 20:02. Can you analyze whether these alarms are correlated and likely part of the same incident?","exampleUseCases":[{"title":"Post-incident alarm cluster review","prompt":"We had three alarms go off in our warehouse between 2am and 2:15am last night — a perimeter sensor, a forced door on the loading dock, and a camera motion alert. Can you analyze these events and tell me if they're correlated and likely one incident or separate occurrences?"},{"title":"SOC triage for multi-zone alerts","prompt":"My security operations center is seeing simultaneous alarms from zones A, B, and C across two buildings — panel alarms, door held-open events, and camera triggers all within 10 minutes. Run a correlation analysis on these events and tell me which ones form a cluster and how confident you are it's a real threat."},{"title":"False alarm vs real threat classification","prompt":"We get a lot of nuisance alarms from our HVAC sensors and door contacts. I have 50 alarm events from the past hour across our facility. Can you correlate them and tell me which clusters look like genuine security incidents versus isolated noise?"}],"resultDescription":"Returns a JSON object with correlated alarm clusters ('items'), each including a cluster ID, title, first/last timestamps, confidence level, observed facts, inferred threat hypothesis, related event IDs, and whether a physical incident is confirmed. Also includes top-level status, findings with codes and details, the analysis timestamp, item count, and explicit limitations about what the service can and cannot determine.","failureModes":["Missing or malformed event timestamps cause correlation windows to fail","No events provided results in empty items array with no findings","Events with missing required fields (category, outcome) may reduce correlation accuracy","Payloads exceeding 200,000 character limit for csv/json/text fields are rejected","Confidence is 'medium' or 'low' when fewer than 3 correlated events are present","Service does not contact physical security systems; missing data is not filled in"],"whenToPreferThis":"Choose this endpoint when you need to correlate raw physical security alarm events — from doors, cameras, sensors, IoT devices, and alarm panels — to detect whether clustered events represent a single incident. Ideal for SOC triage, post-incident review, or any workflow ingesting physical access and alarm logs. Prefer this over generic anomaly detection when your data includes structured security event fields like zone, deviceId, outcome, and category.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:44.251Z","isFirstParty":false,"canonicalSlug":"brainiac-physical-security-alarm-correlation-analyzer-2b5d1a7f"}