Telecom & Network Infrastructure Intelligence API Documentation

POSThttps://www.brainiac.software/api/v1/network-intelligence/log-normalize$0.03 USDC

Normalize network logs

Normalize caller-supplied network/syslog rows. Private addresses in caller data are retained but never contacted.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`logs`	No	array; Array
`latencySamples`	No	array; Array
`packetLossSamples`	No	array; Array
`dnsRecords`	No	array; Array
`bgpRoutes`	No	array; Array
`certificates`	No	array; Array
`configs`	No	array; Array
`reputations`	No	array; Array
`incidents`	No	array; Array
`publicDns`	No	object; Object
`publicTls`	No	object; Object
`asOf`	No	string
`latencyAnomalyZ`	No	number
`packetLossWarnPct`	No	number
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "logs": [
    {
      "id": "L1",
      "at": "2026-11-04T20:00:00.000Z",
      "host": "edge-1",
      "facility": "local0",
      "severity": "info",
      "message": "link up",
      "sourceIp": "203.0.113.10",
      "destinationIp": "198.51.100.20",
      "source": "Caller-supplied syslog"
    },
    {
      "id": "L2",
      "at": "2026-11-04T20:05:00.000Z",
      "host": "edge-1",
      "facility": "local0",
      "severity": "error",
      "message": "BGP session timeout",
      "source": "Caller-supplied syslog"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "normalized",
  "logCount": 2,
  "items": [
    {
      "id": "L1",
      "at": "2026-11-04T20:00:00.000Z",
      "host": "edge-1",
      "facility": "local0",
      "severity": "info",
      "message": "link up",
      "sourceIp": "203.0.113.10",
      "destinationIp": "198.51.100.20",
      "source": "Caller-supplied syslog",
      "paidReputationApiUsed": false,
      "privateNetworkScanned": false
    },
    {
      "id": "L2",
      "at": "2026-11-04T20:05:00.000Z",
      "host": "edge-1",
      "facility": "local0",
      "severity": "error",
      "message": "BGP session timeout",
      "sourceIp": "",
      "destinationIp": "",
      "source": "Caller-supplied syslog",
      "paidReputationApiUsed": false,
      "privateNetworkScanned": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidReputationApiUsed": false,
  "privateNetworkScanned": false,
  "intrusiveScanPerformed": false,
  "publicDnsQueried": false,
  "publicTlsInspected": false,
  "findings": [
    {
      "kind": "observation",
      "code": "private_source_ip",
      "subject": "L1",
      "detail": "Source IP is in a private/special range; it is retained from caller data only and not contacted."
    },
    {
      "kind": "observation",
      "code": "private_destination_ip",
      "subject": "L1",
      "detail": "Destination IP is in a private/special range; it is retained from caller data only and not contacted."
    }
  ],
  "limitations": [
    "Network logs, latency/packet-loss samples, DNS answers, BGP routes, certificates, configs, reputation labels, and incidents are copied only from labeled fields supplied by the caller, or from optional key-free public DNS / public TLS port-443 inspection when explicitly requested.",
    "Private, loopback, link-local, and documentation addresses are never contacted. Private networks are not scanned.",
    "No intrusive security testing is performed and no paid reputation API is used.",
    "IP reputation uses only caller-supplied labels/observations. Missing reputation data is not invented.",
    "Infrastructure health reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/network-intelligence/log-normalize" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "logs": [
    {
      "id": "L1",
      "at": "2026-11-04T20:00:00.000Z",
      "host": "edge-1",
      "facility": "local0",
      "severity": "info",
      "message": "link up",
      "sourceIp": "203.0.113.10",
      "destinationIp": "198.51.100.20",
      "source": "Caller-supplied syslog"
    },
    {
      "id": "L2",
      "at": "2026-11-04T20:05:00.000Z",
      "host": "edge-1",
      "facility": "local0",
      "severity": "error",
      "message": "BGP session timeout",
      "source": "Caller-supplied syslog"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/network-intelligence/latency-anomaly-detect$0.03 USDC

Detect network latency anomalies

Detect anomalous latency using z-scores on caller-supplied path samples. No active probing of private networks.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`logs`	No	array; Array
`latencySamples`	No	array; Array
`packetLossSamples`	No	array; Array
`dnsRecords`	No	array; Array
`bgpRoutes`	No	array; Array
`certificates`	No	array; Array
`configs`	No	array; Array
`reputations`	No	array; Array
`incidents`	No	array; Array
`publicDns`	No	object; Object
`publicTls`	No	object; Object
`asOf`	No	string
`latencyAnomalyZ`	No	number
`packetLossWarnPct`	No	number
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "latencyAnomalyZ": 2,
  "latencySamples": [
    {
      "id": "A1",
      "pathId": "POP-A",
      "host": "cdn.example",
      "at": "2026-11-04T20:00:00.000Z",
      "latencyMs": 20,
      "source": "Caller-supplied probe"
    },
    {
      "id": "A2",
      "pathId": "POP-A",
      "host": "cdn.example",
      "at": "2026-11-04T20:01:00.000Z",
      "latencyMs": 22,
      "source": "Caller-supplied probe"
    },
    {
      "id": "A3",
      "pathId": "POP-A",
      "host": "cdn.example",
      "at": "2026-11-04T20:02:00.000Z",
      "latencyMs": 21,
      "source": "Caller-supplied probe"
    },
    {
      "id": "A4",
      "pathId": "POP-A",
      "host": "cdn.example",
      "at": "2026-11-04T20:03:00.000Z",
      "latencyMs": 19,
      "source": "Caller-supplied probe"
    },
    {
      "id": "A5",
      "pathId": "POP-A",
      "host": "cdn.example",
      "at": "2026-11-04T20:04:00.000Z",
      "latencyMs": 95,
      "source": "Caller-supplied probe"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "detected",
  "seriesCount": 1,
  "anomalyCount": 0,
  "items": [
    {
      "id": "A1",
      "pathId": "POP-A",
      "host": "cdn.example",
      "at": "2026-11-04T20:00:00.000Z",
      "latencyMs": 20,
      "meanMs": 35.4,
      "stdevMs": 33.3362,
      "zScore": -0.462,
      "anomalous": false,
      "source": "Caller-supplied probe",
      "privateNetworkScanned": false
    },
    {
      "id": "A2",
      "pathId": "POP-A",
      "host": "cdn.example",
      "at": "2026-11-04T20:01:00.000Z",
      "latencyMs": 22,
      "meanMs": 35.4,
      "stdevMs": 33.3362,
      "zScore": -0.402,
      "anomalous": false,
      "source": "Caller-supplied probe",
      "privateNetworkScanned": false
    },
    {
      "id": "A3",
      "pathId": "POP-A",
      "host": "cdn.example",
      "at": "2026-11-04T20:02:00.000Z",
      "latencyMs": 21,
      "meanMs": 35.4,
      "stdevMs": 33.3362,
      "zScore": -0.432,
      "anomalous": false,
      "source": "Caller-supplied probe",
      "privateNetworkScanned": false
    },
    {
      "id": "A4",
      "pathId": "POP-A",
      "host": "cdn.example",
      "at": "2026-11-04T20:03:00.000Z",
      "latencyMs": 19,
      "meanMs": 35.4,
      "stdevMs": 33.3362,
      "zScore": -0.492,
      "anomalous": false,
      "source": "Caller-supplied probe",
      "privateNetworkScanned": false
    },
    {
      "id": "A5",
      "pathId": "POP-A",
      "host": "cdn.example",
      "at": "2026-11-04T20:04:00.000Z",
      "latencyMs": 95,
      "meanMs": 35.4,
      "stdevMs": 33.3362,
      "zScore": 1.7878,
      "anomalous": false,
      "source": "Caller-supplied probe",
      "privateNetworkScanned": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidReputationApiUsed": false,
  "privateNetworkScanned": false,
  "intrusiveScanPerformed": false,
  "publicDnsQueried": false,
  "publicTlsInspected": false,
  "findings": [],
  "limitations": [
    "Network logs, latency/packet-loss samples, DNS answers, BGP routes, certificates, configs, reputation labels, and incidents are copied only from labeled fields supplied by the caller, or from optional key-free public DNS / public TLS port-443 inspection when explicitly requested.",
    "Private, loopback, link-local, and documentation addresses are never contacted. Private networks are not scanned.",
    "No intrusive security testing is performed and no paid reputation API is used.",
    "IP reputation uses only caller-supplied labels/observations. Missing reputation data is not invented.",
    "Infrastructure health reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/network-intelligence/latency-anomaly-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",
  "latencyAnomalyZ": 2,
  "latencySamples": [
    {
      "id": "A1",
      "pathId": "POP-A",
      "host": "cdn.example",
      "at": "2026-11-04T20:00:00.000Z",
      "latencyMs": 20,
      "source": "Caller-supplied probe"
    },
    {
      "id": "A2",
      "pathId": "POP-A",
      "host": "cdn.example",
      "at": "2026-11-04T20:01:00.000Z",
      "latencyMs": 22,
      "source": "Caller-supplied probe"
    },
    {
      "id": "A3",
      "pathId": "POP-A",
      "host": "cdn.example",
      "at": "2026-11-04T20:02:00.000Z",
      "latencyMs": 21,
      "source": "Caller-supplied probe"
    },
    {
      "id": "A4",
      "pathId": "POP-A",
      "host": "cdn.example",
      "at": "2026-11-04T20:03:00.000Z",
      "latencyMs": 19,
      "source": "Caller-supplied probe"
    },
    {
      "id": "A5",
      "pathId": "POP-A",
      "host": "cdn.example",
      "at": "2026-11-04T20:04:00.000Z",
      "latencyMs": 95,
      "source": "Caller-supplied probe"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/network-intelligence/packet-loss-pattern-analyze$0.03 USDC

Analyze packet-loss patterns

Analyze caller-supplied packet-loss percent or sent/lost counts against a warning threshold.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`logs`	No	array; Array
`latencySamples`	No	array; Array
`packetLossSamples`	No	array; Array
`dnsRecords`	No	array; Array
`bgpRoutes`	No	array; Array
`certificates`	No	array; Array
`configs`	No	array; Array
`reputations`	No	array; Array
`incidents`	No	array; Array
`publicDns`	No	object; Object
`publicTls`	No	object; Object
`asOf`	No	string
`latencyAnomalyZ`	No	number
`packetLossWarnPct`	No	number
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "packetLossWarnPct": 1,
  "packetLossSamples": [
    {
      "id": "P1",
      "pathId": "POP-A",
      "at": "2026-11-04T20:00:00.000Z",
      "sent": 1000,
      "lost": 2,
      "source": "Caller-supplied"
    },
    {
      "id": "P2",
      "pathId": "POP-A",
      "at": "2026-11-04T20:05:00.000Z",
      "sent": 1000,
      "lost": 40,
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "analyzed",
  "sampleCount": 2,
  "elevatedCount": 1,
  "items": [
    {
      "id": "P1",
      "pathId": "POP-A",
      "host": "",
      "at": "2026-11-04T20:00:00.000Z",
      "sent": 1000,
      "lost": 2,
      "lossPct": 0.2,
      "lossPctSupplied": true,
      "elevated": false,
      "source": "Caller-supplied",
      "privateNetworkScanned": false
    },
    {
      "id": "P2",
      "pathId": "POP-A",
      "host": "",
      "at": "2026-11-04T20:05:00.000Z",
      "sent": 1000,
      "lost": 40,
      "lossPct": 4,
      "lossPctSupplied": true,
      "elevated": true,
      "source": "Caller-supplied",
      "privateNetworkScanned": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidReputationApiUsed": false,
  "privateNetworkScanned": false,
  "intrusiveScanPerformed": false,
  "publicDnsQueried": false,
  "publicTlsInspected": false,
  "findings": [
    {
      "kind": "conflict",
      "code": "packet_loss_elevated",
      "subject": "P2",
      "detail": "Packet loss 4% is at or above warning threshold 1%."
    }
  ],
  "limitations": [
    "Network logs, latency/packet-loss samples, DNS answers, BGP routes, certificates, configs, reputation labels, and incidents are copied only from labeled fields supplied by the caller, or from optional key-free public DNS / public TLS port-443 inspection when explicitly requested.",
    "Private, loopback, link-local, and documentation addresses are never contacted. Private networks are not scanned.",
    "No intrusive security testing is performed and no paid reputation API is used.",
    "IP reputation uses only caller-supplied labels/observations. Missing reputation data is not invented.",
    "Infrastructure health reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/network-intelligence/packet-loss-pattern-analyze" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "packetLossWarnPct": 1,
  "packetLossSamples": [
    {
      "id": "P1",
      "pathId": "POP-A",
      "at": "2026-11-04T20:00:00.000Z",
      "sent": 1000,
      "lost": 2,
      "source": "Caller-supplied"
    },
    {
      "id": "P2",
      "pathId": "POP-A",
      "at": "2026-11-04T20:05:00.000Z",
      "sent": 1000,
      "lost": 40,
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/network-intelligence/dns-resolution-diagnose$0.03 USDC

Diagnose DNS resolution

Diagnose caller-supplied DNS answers against expected values, or optionally query key-free public DNS for a public hostname.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`logs`	No	array; Array
`latencySamples`	No	array; Array
`packetLossSamples`	No	array; Array
`dnsRecords`	No	array; Array
`bgpRoutes`	No	array; Array
`certificates`	No	array; Array
`configs`	No	array; Array
`reputations`	No	array; Array
`incidents`	No	array; Array
`publicDns`	No	object; Object
`publicTls`	No	object; Object
`asOf`	No	string
`latencyAnomalyZ`	No	number
`packetLossWarnPct`	No	number
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "dnsRecords": [
    {
      "id": "D1",
      "hostname": "www.example.com",
      "recordType": "A",
      "answer": "93.184.216.34",
      "expectedAnswer": "93.184.216.34",
      "rcode": "NOERROR",
      "latencyMs": 12,
      "source": "Caller-supplied resolver log"
    },
    {
      "id": "D2",
      "hostname": "api.example.com",
      "recordType": "A",
      "answer": "203.0.113.9",
      "expectedAnswer": "198.51.100.9",
      "rcode": "NOERROR",
      "source": "Caller-supplied resolver log"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "diagnosed",
  "recordCount": 2,
  "unhealthyCount": 1,
  "items": [
    {
      "id": "D1",
      "hostname": "www.example.com",
      "recordType": "A",
      "answer": "93.184.216.34",
      "expectedAnswer": "93.184.216.34",
      "resolver": "",
      "rcode": "NOERROR",
      "latencyMs": 12,
      "latencyMsSupplied": true,
      "issues": [],
      "healthy": true,
      "source": "Caller-supplied resolver log",
      "privateNetworkScanned": false
    },
    {
      "id": "D2",
      "hostname": "api.example.com",
      "recordType": "A",
      "answer": "203.0.113.9",
      "expectedAnswer": "198.51.100.9",
      "resolver": "",
      "rcode": "NOERROR",
      "latencyMs": 0,
      "latencyMsSupplied": false,
      "issues": [
        "answer_mismatch"
      ],
      "healthy": false,
      "source": "Caller-supplied resolver log",
      "privateNetworkScanned": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidReputationApiUsed": false,
  "privateNetworkScanned": false,
  "intrusiveScanPerformed": false,
  "publicDnsQueried": false,
  "publicTlsInspected": false,
  "findings": [
    {
      "kind": "conflict",
      "code": "dns_mismatch",
      "subject": "D2",
      "detail": "DNS answer \"203.0.113.9\" does not match expected \"198.51.100.9\"."
    }
  ],
  "limitations": [
    "Network logs, latency/packet-loss samples, DNS answers, BGP routes, certificates, configs, reputation labels, and incidents are copied only from labeled fields supplied by the caller, or from optional key-free public DNS / public TLS port-443 inspection when explicitly requested.",
    "Private, loopback, link-local, and documentation addresses are never contacted. Private networks are not scanned.",
    "No intrusive security testing is performed and no paid reputation API is used.",
    "IP reputation uses only caller-supplied labels/observations. Missing reputation data is not invented.",
    "Infrastructure health reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/network-intelligence/dns-resolution-diagnose" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "dnsRecords": [
    {
      "id": "D1",
      "hostname": "www.example.com",
      "recordType": "A",
      "answer": "93.184.216.34",
      "expectedAnswer": "93.184.216.34",
      "rcode": "NOERROR",
      "latencyMs": 12,
      "source": "Caller-supplied resolver log"
    },
    {
      "id": "D2",
      "hostname": "api.example.com",
      "recordType": "A",
      "answer": "203.0.113.9",
      "expectedAnswer": "198.51.100.9",
      "rcode": "NOERROR",
      "source": "Caller-supplied resolver log"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/network-intelligence/bgp-route-change-analyze$0.04 USDC

Analyze BGP route changes

Compare before/after BGP route rows for AS-path, next-hop, and origin changes from caller-supplied tables.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`logs`	No	array; Array
`latencySamples`	No	array; Array
`packetLossSamples`	No	array; Array
`dnsRecords`	No	array; Array
`bgpRoutes`	No	array; Array
`certificates`	No	array; Array
`configs`	No	array; Array
`reputations`	No	array; Array
`incidents`	No	array; Array
`publicDns`	No	object; Object
`publicTls`	No	object; Object
`asOf`	No	string
`latencyAnomalyZ`	No	number
`packetLossWarnPct`	No	number
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "bgpRoutes": [
    {
      "id": "B1",
      "prefix": "203.0.113.0/24",
      "peer": "64500",
      "asPath": "64500 64501",
      "nextHop": "198.51.100.1",
      "originAs": "64501",
      "side": "before",
      "source": "Caller-supplied RIB"
    },
    {
      "id": "B2",
      "prefix": "203.0.113.0/24",
      "peer": "64500",
      "asPath": "64500 64502 64501",
      "nextHop": "198.51.100.2",
      "originAs": "64501",
      "side": "after",
      "source": "Caller-supplied RIB"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "analyzed",
  "routeCount": 1,
  "changedCount": 1,
  "items": [
    {
      "key": "203_0_113_0_24_64500",
      "beforeId": "B1",
      "afterId": "B2",
      "prefix": "203.0.113.0/24",
      "peer": "64500",
      "beforeAsPath": "64500 64501",
      "afterAsPath": "64500 64502 64501",
      "beforeNextHop": "198.51.100.1",
      "afterNextHop": "198.51.100.2",
      "changes": [
        "as_path",
        "next_hop"
      ],
      "changed": true,
      "source": "Caller-supplied RIB; Caller-supplied RIB",
      "privateNetworkScanned": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidReputationApiUsed": false,
  "privateNetworkScanned": false,
  "intrusiveScanPerformed": false,
  "publicDnsQueried": false,
  "publicTlsInspected": false,
  "findings": [
    {
      "kind": "conflict",
      "code": "bgp_change",
      "subject": "B1",
      "detail": "BGP route changes: as_path, next_hop."
    }
  ],
  "limitations": [
    "Network logs, latency/packet-loss samples, DNS answers, BGP routes, certificates, configs, reputation labels, and incidents are copied only from labeled fields supplied by the caller, or from optional key-free public DNS / public TLS port-443 inspection when explicitly requested.",
    "Private, loopback, link-local, and documentation addresses are never contacted. Private networks are not scanned.",
    "No intrusive security testing is performed and no paid reputation API is used.",
    "IP reputation uses only caller-supplied labels/observations. Missing reputation data is not invented.",
    "Infrastructure health reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/network-intelligence/bgp-route-change-analyze" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "bgpRoutes": [
    {
      "id": "B1",
      "prefix": "203.0.113.0/24",
      "peer": "64500",
      "asPath": "64500 64501",
      "nextHop": "198.51.100.1",
      "originAs": "64501",
      "side": "before",
      "source": "Caller-supplied RIB"
    },
    {
      "id": "B2",
      "prefix": "203.0.113.0/24",
      "peer": "64500",
      "asPath": "64500 64502 64501",
      "nextHop": "198.51.100.2",
      "originAs": "64501",
      "side": "after",
      "source": "Caller-supplied RIB"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/network-intelligence/certificate-expiry-inventory$0.03 USDC

Inventory TLS certificate expiry

Inventory caller-supplied TLS certificate expiry dates, or optionally inspect a public hostname on port 443 only.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`logs`	No	array; Array
`latencySamples`	No	array; Array
`packetLossSamples`	No	array; Array
`dnsRecords`	No	array; Array
`bgpRoutes`	No	array; Array
`certificates`	No	array; Array
`configs`	No	array; Array
`reputations`	No	array; Array
`incidents`	No	array; Array
`publicDns`	No	object; Object
`publicTls`	No	object; Object
`asOf`	No	string
`latencyAnomalyZ`	No	number
`packetLossWarnPct`	No	number
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "expiryWarningDays": 30,
  "certificates": [
    {
      "id": "C1",
      "host": "www.example.com",
      "commonName": "www.example.com",
      "issuer": "Example CA",
      "notBefore": "2025-01-01T00:00:00.000Z",
      "notAfter": "2026-12-01T00:00:00.000Z",
      "source": "Caller-supplied inventory"
    },
    {
      "id": "C2",
      "host": "legacy.example.com",
      "commonName": "legacy.example.com",
      "issuer": "Example CA",
      "notBefore": "2024-01-01T00:00:00.000Z",
      "notAfter": "2026-10-15T00:00:00.000Z",
      "source": "Caller-supplied inventory"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "inventoried",
  "certificateCount": 2,
  "expiredCount": 1,
  "expiringSoonCount": 1,
  "items": [
    {
      "id": "C1",
      "host": "www.example.com",
      "commonName": "www.example.com",
      "issuer": "Example CA",
      "notBefore": "2025-01-01T00:00:00.000Z",
      "notAfter": "2026-12-01T00:00:00.000Z",
      "daysRemaining": 26.125,
      "daysRemainingSupplied": true,
      "status": "expiring_soon",
      "serialNumber": "",
      "fingerprintSha256": "",
      "source": "Caller-supplied inventory",
      "privateNetworkScanned": false
    },
    {
      "id": "C2",
      "host": "legacy.example.com",
      "commonName": "legacy.example.com",
      "issuer": "Example CA",
      "notBefore": "2024-01-01T00:00:00.000Z",
      "notAfter": "2026-10-15T00:00:00.000Z",
      "daysRemaining": -20.875,
      "daysRemainingSupplied": true,
      "status": "expired",
      "serialNumber": "",
      "fingerprintSha256": "",
      "source": "Caller-supplied inventory",
      "privateNetworkScanned": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidReputationApiUsed": false,
  "privateNetworkScanned": false,
  "intrusiveScanPerformed": false,
  "publicDnsQueried": false,
  "publicTlsInspected": false,
  "findings": [
    {
      "kind": "conflict",
      "code": "cert_status",
      "subject": "C1",
      "detail": "Certificate is expiring_soon (26.125 days from asOf)."
    },
    {
      "kind": "conflict",
      "code": "cert_status",
      "subject": "C2",
      "detail": "Certificate is expired (-20.875 days from asOf)."
    }
  ],
  "limitations": [
    "Network logs, latency/packet-loss samples, DNS answers, BGP routes, certificates, configs, reputation labels, and incidents are copied only from labeled fields supplied by the caller, or from optional key-free public DNS / public TLS port-443 inspection when explicitly requested.",
    "Private, loopback, link-local, and documentation addresses are never contacted. Private networks are not scanned.",
    "No intrusive security testing is performed and no paid reputation API is used.",
    "IP reputation uses only caller-supplied labels/observations. Missing reputation data is not invented.",
    "Infrastructure health reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/network-intelligence/certificate-expiry-inventory" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "expiryWarningDays": 30,
  "certificates": [
    {
      "id": "C1",
      "host": "www.example.com",
      "commonName": "www.example.com",
      "issuer": "Example CA",
      "notBefore": "2025-01-01T00:00:00.000Z",
      "notAfter": "2026-12-01T00:00:00.000Z",
      "source": "Caller-supplied inventory"
    },
    {
      "id": "C2",
      "host": "legacy.example.com",
      "commonName": "legacy.example.com",
      "issuer": "Example CA",
      "notBefore": "2024-01-01T00:00:00.000Z",
      "notAfter": "2026-10-15T00:00:00.000Z",
      "source": "Caller-supplied inventory"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/network-intelligence/configuration-diff$0.03 USDC

Diff network configurations

Diff left/right or before/after network configuration key/value rows from caller-supplied exports.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`logs`	No	array; Array
`latencySamples`	No	array; Array
`packetLossSamples`	No	array; Array
`dnsRecords`	No	array; Array
`bgpRoutes`	No	array; Array
`certificates`	No	array; Array
`configs`	No	array; Array
`reputations`	No	array; Array
`incidents`	No	array; Array
`publicDns`	No	object; Object
`publicTls`	No	object; Object
`asOf`	No	string
`latencyAnomalyZ`	No	number
`packetLossWarnPct`	No	number
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "configs": [
    {
      "id": "K1",
      "deviceId": "edge-1",
      "path": "interfaces/eth0",
      "key": "mtu",
      "value": "1500",
      "side": "before",
      "source": "Caller-supplied"
    },
    {
      "id": "K2",
      "deviceId": "edge-1",
      "path": "interfaces/eth0",
      "key": "mtu",
      "value": "9000",
      "side": "after",
      "source": "Caller-supplied"
    },
    {
      "id": "K3",
      "deviceId": "edge-1",
      "path": "bgp",
      "key": "local-as",
      "value": "64500",
      "side": "before",
      "source": "Caller-supplied"
    },
    {
      "id": "K4",
      "deviceId": "edge-1",
      "path": "bgp",
      "key": "local-as",
      "value": "64500",
      "side": "after",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "diffed",
  "pairCount": 2,
  "changedCount": 1,
  "items": [
    {
      "key": "edge_1_interfaces_eth0_mtu",
      "leftId": "K1",
      "rightId": "K2",
      "deviceId": "edge-1",
      "path": "interfaces/eth0",
      "configKey": "mtu",
      "leftValue": "1500",
      "rightValue": "9000",
      "changed": true,
      "source": "Caller-supplied; Caller-supplied",
      "privateNetworkScanned": false
    },
    {
      "key": "edge_1_bgp_local_as",
      "leftId": "K3",
      "rightId": "K4",
      "deviceId": "edge-1",
      "path": "bgp",
      "configKey": "local-as",
      "leftValue": "64500",
      "rightValue": "64500",
      "changed": false,
      "source": "Caller-supplied; Caller-supplied",
      "privateNetworkScanned": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidReputationApiUsed": false,
  "privateNetworkScanned": false,
  "intrusiveScanPerformed": false,
  "publicDnsQueried": false,
  "publicTlsInspected": false,
  "findings": [
    {
      "kind": "conflict",
      "code": "config_changed",
      "subject": "K1",
      "detail": "Configuration value changed for mtu."
    }
  ],
  "limitations": [
    "Network logs, latency/packet-loss samples, DNS answers, BGP routes, certificates, configs, reputation labels, and incidents are copied only from labeled fields supplied by the caller, or from optional key-free public DNS / public TLS port-443 inspection when explicitly requested.",
    "Private, loopback, link-local, and documentation addresses are never contacted. Private networks are not scanned.",
    "No intrusive security testing is performed and no paid reputation API is used.",
    "IP reputation uses only caller-supplied labels/observations. Missing reputation data is not invented.",
    "Infrastructure health reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/network-intelligence/configuration-diff" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "configs": [
    {
      "id": "K1",
      "deviceId": "edge-1",
      "path": "interfaces/eth0",
      "key": "mtu",
      "value": "1500",
      "side": "before",
      "source": "Caller-supplied"
    },
    {
      "id": "K2",
      "deviceId": "edge-1",
      "path": "interfaces/eth0",
      "key": "mtu",
      "value": "9000",
      "side": "after",
      "source": "Caller-supplied"
    },
    {
      "id": "K3",
      "deviceId": "edge-1",
      "path": "bgp",
      "key": "local-as",
      "value": "64500",
      "side": "before",
      "source": "Caller-supplied"
    },
    {
      "id": "K4",
      "deviceId": "edge-1",
      "path": "bgp",
      "key": "local-as",
      "value": "64500",
      "side": "after",
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/network-intelligence/ip-address-reputation-check$0.03 USDC

Check IP address reputation

Check caller-supplied IP reputation labels/scores only. No paid reputation API is used and private networks are not scanned.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`logs`	No	array; Array
`latencySamples`	No	array; Array
`packetLossSamples`	No	array; Array
`dnsRecords`	No	array; Array
`bgpRoutes`	No	array; Array
`certificates`	No	array; Array
`configs`	No	array; Array
`reputations`	No	array; Array
`incidents`	No	array; Array
`publicDns`	No	object; Object
`publicTls`	No	object; Object
`asOf`	No	string
`latencyAnomalyZ`	No	number
`packetLossWarnPct`	No	number
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "reputations": [
    {
      "id": "R1",
      "ip": "198.51.100.50",
      "listed": false,
      "listName": "Caller blocklist export",
      "score": 10,
      "observedAt": "2026-11-04T12:00:00.000Z",
      "source": "Caller-supplied"
    },
    {
      "id": "R2",
      "ip": "203.0.113.77",
      "listed": true,
      "listName": "Caller blocklist export",
      "category": "spam",
      "score": 85,
      "observedAt": "2026-11-04T12:00:00.000Z",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "checked",
  "subjectCount": 2,
  "riskyCount": 1,
  "items": [
    {
      "id": "R1",
      "ip": "198.51.100.50",
      "hostname": "",
      "listed": false,
      "listedSupplied": true,
      "listName": "Caller blocklist export",
      "category": "",
      "score": 10,
      "scoreSupplied": true,
      "observedAt": "2026-11-04T12:00:00.000Z",
      "risky": false,
      "source": "Caller-supplied",
      "paidReputationApiUsed": false,
      "privateNetworkScanned": false
    },
    {
      "id": "R2",
      "ip": "203.0.113.77",
      "hostname": "",
      "listed": true,
      "listedSupplied": true,
      "listName": "Caller blocklist export",
      "category": "spam",
      "score": 85,
      "scoreSupplied": true,
      "observedAt": "2026-11-04T12:00:00.000Z",
      "risky": true,
      "source": "Caller-supplied",
      "paidReputationApiUsed": false,
      "privateNetworkScanned": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidReputationApiUsed": false,
  "privateNetworkScanned": false,
  "intrusiveScanPerformed": false,
  "publicDnsQueried": false,
  "publicTlsInspected": false,
  "findings": [
    {
      "kind": "observation",
      "code": "private_reputation_ip",
      "subject": "R1",
      "detail": "IP is private/special; retained from caller data only and not queried against any reputation service."
    },
    {
      "kind": "observation",
      "code": "private_reputation_ip",
      "subject": "R2",
      "detail": "IP is private/special; retained from caller data only and not queried against any reputation service."
    },
    {
      "kind": "conflict",
      "code": "reputation_listed",
      "subject": "R2",
      "detail": "Caller-supplied reputation signal indicates risk (listed=true, score=85)."
    }
  ],
  "limitations": [
    "Network logs, latency/packet-loss samples, DNS answers, BGP routes, certificates, configs, reputation labels, and incidents are copied only from labeled fields supplied by the caller, or from optional key-free public DNS / public TLS port-443 inspection when explicitly requested.",
    "Private, loopback, link-local, and documentation addresses are never contacted. Private networks are not scanned.",
    "No intrusive security testing is performed and no paid reputation API is used.",
    "IP reputation uses only caller-supplied labels/observations. Missing reputation data is not invented.",
    "Infrastructure health reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/network-intelligence/ip-address-reputation-check" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "reputations": [
    {
      "id": "R1",
      "ip": "198.51.100.50",
      "listed": false,
      "listName": "Caller blocklist export",
      "score": 10,
      "observedAt": "2026-11-04T12:00:00.000Z",
      "source": "Caller-supplied"
    },
    {
      "id": "R2",
      "ip": "203.0.113.77",
      "listed": true,
      "listName": "Caller blocklist export",
      "category": "spam",
      "score": 85,
      "observedAt": "2026-11-04T12:00:00.000Z",
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/network-intelligence/incident-timeline-build$0.03 USDC

Build network incident timeline

Build a chronological timeline from caller-supplied incidents and severe log events.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`logs`	No	array; Array
`latencySamples`	No	array; Array
`packetLossSamples`	No	array; Array
`dnsRecords`	No	array; Array
`bgpRoutes`	No	array; Array
`certificates`	No	array; Array
`configs`	No	array; Array
`reputations`	No	array; Array
`incidents`	No	array; Array
`publicDns`	No	object; Object
`publicTls`	No	object; Object
`asOf`	No	string
`latencyAnomalyZ`	No	number
`packetLossWarnPct`	No	number
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "incidents": [
    {
      "id": "I1",
      "at": "2026-11-04T19:55:00.000Z",
      "host": "edge-1",
      "severity": "major",
      "title": "Packet loss spike",
      "detail": "Loss exceeded 5%",
      "source": "Caller-supplied NOC"
    },
    {
      "id": "I2",
      "at": "2026-11-04T20:10:00.000Z",
      "host": "edge-1",
      "severity": "minor",
      "title": "Recovered",
      "detail": "Loss returned to baseline",
      "source": "Caller-supplied NOC"
    }
  ],
  "logs": [
    {
      "id": "L1",
      "at": "2026-11-04T20:00:00.000Z",
      "host": "edge-1",
      "severity": "error",
      "message": "interface flap",
      "source": "Caller-supplied syslog"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "built",
  "eventCount": 3,
  "items": [
    {
      "id": "I1",
      "at": "2026-11-04T19:55:00.000Z",
      "kind": "incident",
      "host": "edge-1",
      "severity": "major",
      "title": "Packet loss spike",
      "detail": "Loss exceeded 5%",
      "source": "Caller-supplied NOC",
      "privateNetworkScanned": false
    },
    {
      "id": "L1",
      "at": "2026-11-04T20:00:00.000Z",
      "kind": "log",
      "host": "edge-1",
      "severity": "error",
      "title": "interface flap",
      "detail": "interface flap",
      "source": "Caller-supplied syslog",
      "privateNetworkScanned": false
    },
    {
      "id": "I2",
      "at": "2026-11-04T20:10:00.000Z",
      "kind": "incident",
      "host": "edge-1",
      "severity": "minor",
      "title": "Recovered",
      "detail": "Loss returned to baseline",
      "source": "Caller-supplied NOC",
      "privateNetworkScanned": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidReputationApiUsed": false,
  "privateNetworkScanned": false,
  "intrusiveScanPerformed": false,
  "publicDnsQueried": false,
  "publicTlsInspected": false,
  "findings": [],
  "limitations": [
    "Network logs, latency/packet-loss samples, DNS answers, BGP routes, certificates, configs, reputation labels, and incidents are copied only from labeled fields supplied by the caller, or from optional key-free public DNS / public TLS port-443 inspection when explicitly requested.",
    "Private, loopback, link-local, and documentation addresses are never contacted. Private networks are not scanned.",
    "No intrusive security testing is performed and no paid reputation API is used.",
    "IP reputation uses only caller-supplied labels/observations. Missing reputation data is not invented.",
    "Infrastructure health reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/network-intelligence/incident-timeline-build" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "incidents": [
    {
      "id": "I1",
      "at": "2026-11-04T19:55:00.000Z",
      "host": "edge-1",
      "severity": "major",
      "title": "Packet loss spike",
      "detail": "Loss exceeded 5%",
      "source": "Caller-supplied NOC"
    },
    {
      "id": "I2",
      "at": "2026-11-04T20:10:00.000Z",
      "host": "edge-1",
      "severity": "minor",
      "title": "Recovered",
      "detail": "Loss returned to baseline",
      "source": "Caller-supplied NOC"
    }
  ],
  "logs": [
    {
      "id": "L1",
      "at": "2026-11-04T20:00:00.000Z",
      "host": "edge-1",
      "severity": "error",
      "message": "interface flap",
      "source": "Caller-supplied syslog"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/network-intelligence/infrastructure-health-report$0.08 USDC

Build network infrastructure health report

Aggregate log, latency, packet-loss, DNS, BGP, certificate, configuration, reputation, and incident sections from caller-supplied network records.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`files`	No	array; Array
`logs`	No	array; Array
`latencySamples`	No	array; Array
`packetLossSamples`	No	array; Array
`dnsRecords`	No	array; Array
`bgpRoutes`	No	array; Array
`certificates`	No	array; Array
`configs`	No	array; Array
`reputations`	No	array; Array
`incidents`	No	array; Array
`publicDns`	No	object; Object
`publicTls`	No	object; Object
`asOf`	No	string
`latencyAnomalyZ`	No	number
`packetLossWarnPct`	No	number
`expiryWarningDays`	No	number

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "latencyAnomalyZ": 2,
  "packetLossWarnPct": 1,
  "expiryWarningDays": 30,
  "logs": [
    {
      "at": "2026-11-04T20:00:00.000Z",
      "host": "edge-1",
      "severity": "error",
      "message": "BGP session timeout",
      "source": "Caller-supplied"
    }
  ],
  "latencySamples": [
    {
      "pathId": "POP-A",
      "at": "2026-11-04T20:00:00.000Z",
      "latencyMs": 20,
      "source": "Caller-supplied"
    },
    {
      "pathId": "POP-A",
      "at": "2026-11-04T20:01:00.000Z",
      "latencyMs": 22,
      "source": "Caller-supplied"
    },
    {
      "pathId": "POP-A",
      "at": "2026-11-04T20:02:00.000Z",
      "latencyMs": 21,
      "source": "Caller-supplied"
    },
    {
      "pathId": "POP-A",
      "at": "2026-11-04T20:03:00.000Z",
      "latencyMs": 95,
      "source": "Caller-supplied"
    }
  ],
  "packetLossSamples": [
    {
      "pathId": "POP-A",
      "sent": 1000,
      "lost": 40,
      "source": "Caller-supplied"
    }
  ],
  "dnsRecords": [
    {
      "hostname": "www.example.com",
      "recordType": "A",
      "answer": "93.184.216.34",
      "expectedAnswer": "93.184.216.34",
      "rcode": "NOERROR",
      "source": "Caller-supplied"
    }
  ],
  "bgpRoutes": [
    {
      "prefix": "203.0.113.0/24",
      "peer": "64500",
      "asPath": "64500 64501",
      "nextHop": "198.51.100.1",
      "side": "before",
      "source": "Caller-supplied"
    },
    {
      "prefix": "203.0.113.0/24",
      "peer": "64500",
      "asPath": "64500 64502 64501",
      "nextHop": "198.51.100.2",
      "side": "after",
      "source": "Caller-supplied"
    }
  ],
  "certificates": [
    {
      "host": "www.example.com",
      "commonName": "www.example.com",
      "notAfter": "2026-12-01T00:00:00.000Z",
      "source": "Caller-supplied"
    }
  ],
  "configs": [
    {
      "deviceId": "edge-1",
      "key": "mtu",
      "value": "1500",
      "side": "before",
      "source": "Caller-supplied"
    },
    {
      "deviceId": "edge-1",
      "key": "mtu",
      "value": "9000",
      "side": "after",
      "source": "Caller-supplied"
    }
  ],
  "reputations": [
    {
      "ip": "203.0.113.77",
      "listed": true,
      "score": 85,
      "source": "Caller-supplied"
    }
  ],
  "incidents": [
    {
      "at": "2026-11-04T19:55:00.000Z",
      "host": "edge-1",
      "severity": "major",
      "title": "Packet loss spike",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "reported",
  "asOf": "2026-11-04T21:00:00.000Z",
  "sections": {
    "logs": {
      "logCount": 1
    },
    "latency": {
      "seriesCount": 1,
      "anomalyCount": 0
    },
    "packetLoss": {
      "sampleCount": 1,
      "elevatedCount": 1
    },
    "dns": {
      "recordCount": 1,
      "unhealthyCount": 0
    },
    "bgp": {
      "routeCount": 1,
      "changedCount": 1
    },
    "certificates": {
      "certificateCount": 1,
      "expiredCount": 0,
      "expiringSoonCount": 1
    },
    "configuration": {
      "pairCount": 1,
      "changedCount": 1
    },
    "reputation": {
      "subjectCount": 1,
      "riskyCount": 1
    },
    "incidents": {
      "eventCount": 2
    }
  },
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "paidReputationApiUsed": false,
  "privateNetworkScanned": false,
  "intrusiveScanPerformed": false,
  "publicDnsQueried": false,
  "publicTlsInspected": false,
  "findings": [
    {
      "kind": "conflict",
      "code": "packet_loss_elevated",
      "subject": "PLS-1",
      "detail": "Packet loss 4% is at or above warning threshold 1%."
    },
    {
      "kind": "conflict",
      "code": "bgp_change",
      "subject": "BGP-1",
      "detail": "BGP route changes: as_path, next_hop."
    },
    {
      "kind": "conflict",
      "code": "cert_status",
      "subject": "CRT-1",
      "detail": "Certificate is expiring_soon (26.125 days from asOf)."
    },
    {
      "kind": "conflict",
      "code": "config_changed",
      "subject": "CFG-1",
      "detail": "Configuration value changed for mtu."
    },
    {
      "kind": "observation",
      "code": "private_reputation_ip",
      "subject": "REP-1",
      "detail": "IP is private/special; retained from caller data only and not queried against any reputation service."
    },
    {
      "kind": "conflict",
      "code": "reputation_listed",
      "subject": "REP-1",
      "detail": "Caller-supplied reputation signal indicates risk (listed=true, score=85)."
    }
  ],
  "limitations": [
    "Network logs, latency/packet-loss samples, DNS answers, BGP routes, certificates, configs, reputation labels, and incidents are copied only from labeled fields supplied by the caller, or from optional key-free public DNS / public TLS port-443 inspection when explicitly requested.",
    "Private, loopback, link-local, and documentation addresses are never contacted. Private networks are not scanned.",
    "No intrusive security testing is performed and no paid reputation API is used.",
    "IP reputation uses only caller-supplied labels/observations. Missing reputation data is not invented.",
    "Infrastructure health reports aggregate only sections for which records were supplied or optionally fetched."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/network-intelligence/infrastructure-health-report" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "latencyAnomalyZ": 2,
  "packetLossWarnPct": 1,
  "expiryWarningDays": 30,
  "logs": [
    {
      "at": "2026-11-04T20:00:00.000Z",
      "host": "edge-1",
      "severity": "error",
      "message": "BGP session timeout",
      "source": "Caller-supplied"
    }
  ],
  "latencySamples": [
    {
      "pathId": "POP-A",
      "at": "2026-11-04T20:00:00.000Z",
      "latencyMs": 20,
      "source": "Caller-supplied"
    },
    {
      "pathId": "POP-A",
      "at": "2026-11-04T20:01:00.000Z",
      "latencyMs": 22,
      "source": "Caller-supplied"
    },
    {
      "pathId": "POP-A",
      "at": "2026-11-04T20:02:00.000Z",
      "latencyMs": 21,
      "source": "Caller-supplied"
    },
    {
      "pathId": "POP-A",
      "at": "2026-11-04T20:03:00.000Z",
      "latencyMs": 95,
      "source": "Caller-supplied"
    }
  ],
  "packetLossSamples": [
    {
      "pathId": "POP-A",
      "sent": 1000,
      "lost": 40,
      "source": "Caller-supplied"
    }
  ],
  "dnsRecords": [
    {
      "hostname": "www.example.com",
      "recordType": "A",
      "answer": "93.184.216.34",
      "expectedAnswer": "93.184.216.34",
      "rcode": "NOERROR",
      "source": "Caller-supplied"
    }
  ],
  "bgpRoutes": [
    {
      "prefix": "203.0.113.0/24",
      "peer": "64500",
      "asPath": "64500 64501",
      "nextHop": "198.51.100.1",
      "side": "before",
      "source": "Caller-supplied"
    },
    {
      "prefix": "203.0.113.0/24",
      "peer": "64500",
      "asPath": "64500 64502 64501",
      "nextHop": "198.51.100.2",
      "side": "after",
      "source": "Caller-supplied"
    }
  ],
  "certificates": [
    {
      "host": "www.example.com",
      "commonName": "www.example.com",
      "notAfter": "2026-12-01T00:00:00.000Z",
      "source": "Caller-supplied"
    }
  ],
  "configs": [
    {
      "deviceId": "edge-1",
      "key": "mtu",
      "value": "1500",
      "side": "before",
      "source": "Caller-supplied"
    },
    {
      "deviceId": "edge-1",
      "key": "mtu",
      "value": "9000",
      "side": "after",
      "source": "Caller-supplied"
    }
  ],
  "reputations": [
    {
      "ip": "203.0.113.77",
      "listed": true,
      "score": 85,
      "source": "Caller-supplied"
    }
  ],
  "incidents": [
    {
      "at": "2026-11-04T19:55:00.000Z",
      "host": "edge-1",
      "severity": "major",
      "title": "Packet loss spike",
      "source": "Caller-supplied"
    }
  ]
}
JSON