{"openapi":"3.1.0","info":{"title":"Network Exposure & Certificate Tooling API","version":"1.0.0","description":"CIDR math, exposure diffs, Recog banner fingerprints, CPE matching, CVSS scoring, JA3/JA4, X.509/CSR decode, Mozilla chain build, SSH key audit, Nmap summarisation, port risk tiers, firewall anomalies, DNS zone audit and offline DNSSEC — pure compute on caller-supplied blobs. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses x402 with exact USDC on Base (8453). Each paid resource accepts POST for the call; unpaid GET/HEAD return the same 402 payment challenge for discovery.\nHow to call an operation:\n1. POST JSON matching the requestBody. An unpaid POST (including empty body) returns 402 payment terms before body validation.\n2. Compare 402 payTo, asset, and network with /api/v1/catalog and /.well-known/x402 — not only with the 402 itself.\n3. Pay and retry with payment-signature. Invalid JSON/schema after payment-signature returns 400 and is not charged. Settlement (a charge) only on 2xx. payment-signature attached ≠ charged.\nIdempotency-Key: 64 hex chars from 32 random bytes. Reuse only for the same operation and body (replays stored response, including status=partial). A new key runs a fresh call.\nIdempotency after errors: unpaid 402 does not store the key. Post-signature 402/503 release it (retry same key). Pre-reserve schema 400 does not store it. Other post-signature responses (2xx/4xx/5xx) are stored: same key+body replays; different body → 409. Stored 4xx/5xx replays are not a second charge. Prefer a new key after fixing a 4xx; after 5xx reuse the same key only for the stored error.\nPost-signature 402/503 include prior-payment-attempt (nonce, settled false|unknown). A facilitator 502 is SETTLEMENT_UNKNOWN (stored under the Idempotency-Key; cross-instance replay needs the shared store; may already be charged) — check USDC authorizationState(payer, nonce) on Base before re-signing.\nSettlement signal: settled 2xx include payment-response. 4xx/5xx do not. Do not book a cost from payment-signature alone.\nCoverage billing: HTTP 200 with status complete, partial, or failed is charged at the full listed price. Retrying missing checks needs a new settled call. 4xx/5xx are not charged.\nmissing_items.reason: timeout/rate_limited → one delayed retry (new key); upstream_down → after recovery; not_supported → never.\nInvariants: any missing_items ⇒ not status complete; sources[] is provenance only (source, url, retrievedAt), never success/error keyed by check.\nFree lookup: GET /api/v1/results/{result_id} returns stored coverage JSON (404 RESULT_NOT_FOUND if unknown/expired; not a 402). Prior-Result-Id sets replaces_result_id.\nOutputs are prechecks/drafts for human review — not official determinations, legal advice, or certified filings."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/network-exposure/cidr-calculate":{"post":{"operationId":"calculate_ipv4_ipv6_cidr_details_aggregates_and_relations","summary":"Calculate IPv4/IPv6 CIDR details, aggregates and relations","description":"Describe, aggregate or relate CIDR blocks without network access.","tags":["network-exposure"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"operation":{"type":"string","const":"describe"},"cidr":{"type":"string","minLength":3,"maxLength":80}},"required":["operation","cidr"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"aggregate"},"cidrs":{"minItems":1,"maxItems":100000,"type":"array","items":{"type":"string","minLength":3,"maxLength":80}}},"required":["operation","cidrs"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"relate"},"a":{"type":"string","minLength":3,"maxLength":80},"b":{"type":"string","minLength":3,"maxLength":80}},"required":["operation","a","b"],"additionalProperties":false}]},"example":{"operation":"describe","cidr":"192.168.10.37/27"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"string"},"network":{"type":"string"},"hostBitsSet":{"type":"boolean"},"version":{"type":"number"},"netmask":{"type":"string"},"hostmask":{"type":"string"},"broadcast":{"type":"string"},"firstHost":{"type":"string"},"lastHost":{"type":"string"},"addresses":{"type":"string"},"usableHosts":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"input":"192.168.10.37/27","network":"192.168.10.32/27","hostBitsSet":true,"version":4,"netmask":"255.255.255.224","hostmask":"0.0.0.31","broadcast":"192.168.10.63","firstHost":"192.168.10.33","lastHost":"192.168.10.62","addresses":"32","usableHosts":"30","sources":[{"source":"Caller-supplied scan output, banners, certificates, rule sets or zone files processed locally","url":"https://www.brainiac.software/api/v1/network-exposure","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Pure computation on caller input: nothing is scanned, resolved or fetched at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/network-exposure/ip-list-diff":{"post":{"operationId":"diff_two_host_service_exposure_snapshots","summary":"Diff two host/service exposure snapshots","description":"Report new, closed and changed services between before and after snapshots.","tags":["network-exposure"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"before":{"maxItems":200000,"type":"array","items":{"type":"object","properties":{"ip":{"type":"string","minLength":1,"maxLength":80},"port":{"type":"integer","minimum":0,"maximum":65535},"protocol":{"default":"tcp","type":"string","enum":["tcp","udp","sctp"]},"service":{"type":"string","maxLength":4096},"banner":{"type":"string","maxLength":4096}},"required":["ip","port"],"additionalProperties":false}},"after":{"maxItems":200000,"type":"array","items":{"type":"object","properties":{"ip":{"type":"string","minLength":1,"maxLength":80},"port":{"type":"integer","minimum":0,"maximum":65535},"protocol":{"default":"tcp","type":"string","enum":["tcp","udp","sctp"]},"service":{"type":"string","maxLength":4096},"banner":{"type":"string","maxLength":4096}},"required":["ip","port"],"additionalProperties":false}}},"required":["before","after"],"additionalProperties":false},"example":{"before":[{"ip":"198.51.100.10","port":22,"protocol":"tcp","service":"ssh","banner":"OpenSSH_8.9p1"},{"ip":"198.51.100.10","port":80,"protocol":"tcp","service":"http","banner":"nginx/1.24.0"},{"ip":"198.51.100.11","port":3306,"protocol":"tcp","service":"mysql"}],"after":[{"ip":"198.51.100.10","port":22,"protocol":"tcp","service":"ssh","banner":"OpenSSH_9.6p1"},{"ip":"198.51.100.10","port":80,"protocol":"tcp","service":"http","banner":"nginx/1.24.0"},{"ip":"198.51.100.12","port":3389,"protocol":"tcp","service":"ms-wbt-server"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"new":{"type":"array","items":{"type":"object","properties":{"ip":{"type":"string"},"port":{"type":"number"},"protocol":{"type":"string"},"service":{"type":"string"}},"additionalProperties":true}},"closed":{"type":"array","items":{"type":"object","properties":{"ip":{"type":"string"},"port":{"type":"number"},"protocol":{"type":"string"},"service":{"type":"string"}},"additionalProperties":true}},"changed":{"type":"array","items":{"type":"object","properties":{"ip":{"type":"string"},"port":{"type":"number"},"protocol":{"type":"string"},"fields":{"type":"object","properties":{"banner":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"additionalProperties":true}},"unchanged":{"type":"number"},"newHosts":{"type":"array","items":{"type":"string"}},"goneHosts":{"type":"array","items":{"type":"string"}},"duplicates":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"new":[{"ip":"198.51.100.12","port":3389,"protocol":"tcp","service":"ms-wbt-server"}],"closed":[{"ip":"198.51.100.11","port":3306,"protocol":"tcp","service":"mysql"}],"changed":[{"ip":"198.51.100.10","port":22,"protocol":"tcp","fields":{"banner":["OpenSSH_8.9p1","OpenSSH_9.6p1"]}}],"unchanged":1,"newHosts":["198.51.100.12"],"goneHosts":["198.51.100.11"],"duplicates":0,"sources":[{"source":"Caller-supplied scan output, banners, certificates, rule sets or zone files processed locally","url":"https://www.brainiac.software/api/v1/network-exposure","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Pure computation on caller input: nothing is scanned, resolved or fetched at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/network-exposure/service-banner-fingerprint":{"post":{"operationId":"fingerprint_service_banners_with_recog","summary":"Fingerprint service banners with Recog","description":"Match banners against vendored Rapid7 Recog fingerprints.","tags":["network-exposure"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"minItems":1,"maxItems":10000,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","minLength":1,"maxLength":64},"value":{"type":"string","maxLength":4096}},"required":["type","value"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false},"example":{"items":[{"type":"ssh_banner","value":"OpenSSH_8.9p1 Ubuntu-3ubuntu0.6"},{"type":"http_server","value":"nginx/1.24.0"},{"type":"http_server","value":"Apache/2.4.58 (Ubuntu)"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":["object","string"],"properties":{"value":{"type":"string"},"matches":{"type":"array","items":{"type":"object","properties":{"description":{"type":"string"},"params":{"type":"object","properties":{"service.version":{"type":"string"},"openssh.comment":{"type":"string"},"service.vendor":{"type":"string"},"service.family":{"type":"string"},"service.product":{"type":"string"},"service.cpe23":{"type":"string"},"os.vendor":{"type":"string"},"os.family":{"type":"string"},"os.product":{"type":"string"},"os.certainty":{"type":"string"},"os.cpe23":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true}}},"additionalProperties":true}},"recogRevision":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"results":[{"value":"OpenSSH_8.9p1 Ubuntu-3ubuntu0.6","matches":[{"description":"OpenSSH running on Ubuntu","params":{"service.version":"8.9p1","openssh.comment":"Ubuntu-3ubuntu0.6","service.vendor":"OpenBSD","service.family":"OpenSSH","service.product":"OpenSSH","service.cpe23":"cpe:/a:openbsd:openssh:8.9p1","os.vendor":"Ubuntu","os.family":"Linux","os.product":"Linux","os.certainty":"0.75","os.cpe23":"cpe:/o:canonical:ubuntu_linux:-"}}]},{"value":"nginx/1.24.0","matches":[{"description":"nginx with version info and/or mods","params":{"service.product":"nginx","service.family":"nginx","service.vendor":"nginx","service.version":"1.24.0","service.cpe23":"cpe:/a:f5:nginx:1.24.0"}}]},"…"],"recogRevision":"f1191e24332c51d6a3d98457f64fba8dec340784","sources":[{"source":"Caller-supplied scan output, banners, certificates, rule sets or zone files processed locally","url":"https://www.brainiac.software/api/v1/network-exposure","retrievedAt":"2026-11-14","status":"ok"},{"source":"Rapid7 Recog fingerprints (BSD-2-Clause)","url":"https://github.com/rapid7/recog","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Pure computation on caller input: nothing is scanned, resolved or fetched at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/network-exposure/cpe-parse-match":{"post":{"operationId":"parse_cpe_strings_and_match_criteria","summary":"Parse CPE strings and match criteria","description":"Unbind CPE 2.2/2.3 names and test version-range criteria.","tags":["network-exposure"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"cpe":{"type":"string","minLength":1,"maxLength":1024},"criteria":{"default":[],"maxItems":1000,"type":"array","items":{"type":"object","properties":{"criteria":{"type":"string","minLength":1,"maxLength":1024},"versionStartIncluding":{"type":"string","maxLength":128},"versionStartExcluding":{"type":"string","maxLength":128},"versionEndIncluding":{"type":"string","maxLength":128},"versionEndExcluding":{"type":"string","maxLength":128}},"required":["criteria"],"additionalProperties":false}}},"required":["cpe"],"additionalProperties":false},"example":{"cpe":"cpe:/a:apache:http_server:2.4.49","criteria":[{"criteria":"cpe:2.3:a:apache:http_server:*:*:*:*:*:*:*:*","versionStartIncluding":"2.4.0","versionEndExcluding":"2.4.51"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"wfn":{"type":"object","properties":{"part":{"type":"string"},"vendor":{"type":"string"},"product":{"type":"string"},"version":{"type":"string"},"update":{"type":"string"},"edition":{"type":"string"},"language":{"type":"string"},"sw_edition":{"type":"string"},"target_sw":{"type":"string"},"target_hw":{"type":"string"},"other":{"type":"string"}},"additionalProperties":true},"formattedString":{"type":"string"},"uri":{"type":"string"},"matches":{"type":"array","items":{"type":"object","properties":{"index":{"type":"number"},"match":{"type":"boolean"}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"wfn":{"part":"a","vendor":"apache","product":"http_server","version":"2.4.49","update":"ANY","edition":"ANY","language":"ANY","sw_edition":"ANY","target_sw":"ANY","target_hw":"ANY","other":"ANY"},"formattedString":"cpe:2.3:a:apache:http_server:2.4.49:*:*:*:*:*:*:*","uri":"cpe:/a:apache:http_server:2.4.49","matches":[{"index":0,"match":true}],"sources":[{"source":"Caller-supplied scan output, banners, certificates, rule sets or zone files processed locally","url":"https://www.brainiac.software/api/v1/network-exposure","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Pure computation on caller input: nothing is scanned, resolved or fetched at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/network-exposure/cvss-calculate":{"post":{"operationId":"calculate_cvss_v3_1_and_v4_0_scores","summary":"Calculate CVSS v3.1 and v4.0 scores","description":"Validate a CVSS vector and compute base/temporal/environmental or v4 scores.","tags":["network-exposure"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"vector":{"type":"string","minLength":8,"maxLength":512}},"required":["vector"],"additionalProperties":false},"example":{"vector":"CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N/E:U"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string"},"valid":{"type":"boolean"},"score":{"type":"number"},"severity":{"type":"string"},"nomenclature":{"type":"string"},"macroVector":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"version":"4.0","valid":true,"score":8.1,"severity":"High","nomenclature":"CVSS-BT","macroVector":"000220","sources":[{"source":"Caller-supplied scan output, banners, certificates, rule sets or zone files processed locally","url":"https://www.brainiac.software/api/v1/network-exposure","retrievedAt":"2026-11-14","status":"ok"},{"source":"FIRST CVSS v4.0 calculator data (BSD-2-Clause)","url":"https://github.com/FIRSTdotorg/cvss-v4-calculator","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Pure computation on caller input: nothing is scanned, resolved or fetched at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/network-exposure/tls-fingerprint-compute":{"post":{"operationId":"compute_ja3_and_ja4_tls_fingerprints","summary":"Compute JA3 and JA4 TLS fingerprints","description":"Derive JA3/JA4 from ClientHello fields without capturing traffic.","tags":["network-exposure"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"transport":{"default":"tcp","type":"string","enum":["tcp","quic","dtls"]},"legacyVersion":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"supportedVersions":{"type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"ciphers":{"type":"array","items":{"type":"string","pattern":"^[0-9a-fA-F]{4}$"}},"extensions":{"type":"array","items":{"type":"string","pattern":"^[0-9a-fA-F]{4}$"}},"signatureAlgorithms":{"type":"array","items":{"type":"string","pattern":"^[0-9a-fA-F]{4}$"}},"alpn":{"type":"array","items":{"type":"string","maxLength":64}},"supportedGroups":{"type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"ecPointFormats":{"type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"clientHelloHex":{"type":"string","maxLength":32768}},"additionalProperties":false},"example":{"transport":"tcp","legacyVersion":771,"supportedVersions":[772,771],"ciphers":["1301","1302","1303","c02b","c02f","c02c","c030","cca9","cca8","c013","c014","009c","009d","002f","0035"],"extensions":["001b","0000","0033","0010","4469","0017","002d","000d","0005","0023","0012","002b","ff01","000b","000a","0015"],"signatureAlgorithms":["0403","0804","0401","0503","0805","0501","0806","0601"],"alpn":["h2","http/1.1"],"supportedGroups":[29,23,24],"ecPointFormats":[0]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ja4":{"type":"string"},"ja4_r":{"type":"string"},"ja3":{"type":"string"},"ja3String":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"ja4":"t13d1516h2_8daaf6152771_e5627efa2ab1","ja4_r":"t13d1516h2_002f,0035,009c,009d,1301,1302,1303,c013,c014,c02b,c02c,c02f,c030,cca8,cca9_0005,000a,000b,000d,0012,0015,001…","ja3":"c000e2caf3a25423f9de6c8a4b12a975","ja3String":"771,4865-4866-4867-49195-49199-49196-49200-52393-52392-49171-49172-156-157-47-53,27-0-51-16-17513-23-45-13-5-35-18-43-6…","sources":[{"source":"Caller-supplied scan output, banners, certificates, rule sets or zone files processed locally","url":"https://www.brainiac.software/api/v1/network-exposure","retrievedAt":"2026-11-14","status":"ok"},{"source":"FoxIO JA4 (BSD-3-Clause) and Salesforce JA3 (BSD-3-Clause)","url":"https://github.com/FoxIO-LLC/ja4","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Pure computation on caller input: nothing is scanned, resolved or fetched at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/network-exposure/x509-decode":{"post":{"operationId":"decode_x_509_certificates_and_flag_weaknesses","summary":"Decode X.509 certificates and flag weaknesses","description":"Parse PEM/DER certificates and apply NIST/BR validity flags.","tags":["network-exposure"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pem":{"type":"string","maxLength":1000000},"derBase64":{"type":"string","maxLength":1000000},"now":{"type":"string"}},"additionalProperties":false},"example":{"pem":"-----BEGIN CERTIFICATE-----\nMIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAwTzELMAkGA1UE\nBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2VhcmNoIEdyb3VwMRUwEwYDVQQD\nEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQG\nEwJVUzEpMCcGA1UEChMgSW50ZXJuZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMT\nDElTUkcgUm9vdCBYMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54r\nVygch77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+0TM8ukj1\n3Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6UA5/TR5d8mUgjU+g4rk8K\nb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sWT8KOEUt+zwvo/7V3LvSye0rgTBIlDHCN\nAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyHB5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ\n4Q7e2RCOFvu396j3x+UCB5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf\n1b0SHzUvKBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWnOlFu\nhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTnjh8BCNAw1FtxNrQH\nusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbwqHyGO0aoSCqI3Haadr8faqU9GY/r\nOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CIrU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4G\nA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY\n9umbbjANBgkqhkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL\nubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ3BebYhtF8GaV\n0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KKNFtY2PwByVS5uCbMiogziUwt\nhDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJw\nTdwJx4nLCgdNbOhdjsnvzqvHu7UrTkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nx\ne5AW0wdeRlN8NwdCjNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZA\nJzVcoyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq4RgqsahD\nYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPAmRGunUHBcnWEvgJBQl9n\nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57demyPxgcYxn/eR44/KJ4EBs+lVDR3veyJ\nm+kXQ99b21/+jh5Xos1AnX5iItreGCc=\n-----END CERTIFICATE-----\n","now":"2026-11-14T00:00:00Z"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"certificates":{"type":"array","items":{"type":"object","properties":{"subject":{"type":"string"},"issuer":{"type":"string"},"selfSigned":{"type":"boolean"},"serialHex":{"type":"string"},"notBefore":{"type":"string"},"notAfter":{"type":"string"},"validity":{"type":"string"},"publicKey":{"type":"object","properties":{"type":{"type":"string"},"bits":{"type":"number"}},"additionalProperties":true},"signatureAlgorithm":{"type":"string"},"sans":{"type":"array","items":{}},"isCA":{"type":"boolean"},"sha256":{"type":"string"},"sha1":{"type":"string"},"flags":{"type":"array","items":{}}},"additionalProperties":true}},"evaluatedAt":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"certificates":[{"subject":"C=US\nO=Internet Security Research Group\nCN=ISRG Root X1","issuer":"C=US\nO=Internet Security Research Group\nCN=ISRG Root X1","selfSigned":true,"serialHex":"8210cfb0d240e3594463e0bb63828b00","notBefore":"2015-06-04T11:04:38Z","notAfter":"2035-06-04T11:04:38Z","validity":"valid","publicKey":{"type":"RSA","bits":4096},"signatureAlgorithm":"sha256WithRSAEncryption","sans":[],"isCA":true,"sha256":"96bcec06264976f37460779acf28c5a7cfe8a3c0aae11a8ffcee05c0bddf08c6","sha1":"cabd2a79a1076a31f21d253635cb039d4329a5e8","flags":[]}],"evaluatedAt":"2026-11-14T00:00:00Z","sources":[{"source":"Caller-supplied scan output, banners, certificates, rule sets or zone files processed locally","url":"https://www.brainiac.software/api/v1/network-exposure","retrievedAt":"2026-11-14","status":"ok"},{"source":"CA/Browser Forum TLS Baseline Requirements v2.3.1 §6.3.2; NIST SP 800-131A Rev. 2","url":"https://cabforum.org/working-groups/server/baseline-requirements/","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Pure computation on caller input: nothing is scanned, resolved or fetched at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/network-exposure/csr-decode-validate":{"post":{"operationId":"decode_and_validate_a_pkcs_10_csr","summary":"Decode and validate a PKCS#10 CSR","description":"Verify CSR self-signature and check key/SAN policy.","tags":["network-exposure"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"csrPem":{"type":"string","minLength":20,"maxLength":65536},"policy":{"default":{"minRsaBits":2048,"allowedKeyTypes":["RSA","EC","Ed25519"],"allowedCurves":["P-256","P-384"],"requireSan":true,"cnMustBeInSan":true},"type":"object","properties":{"minRsaBits":{"default":2048,"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"allowedKeyTypes":{"default":["RSA","EC","Ed25519"],"type":"array","items":{"type":"string","enum":["RSA","EC","Ed25519"]}},"allowedCurves":{"default":["P-256","P-384"],"type":"array","items":{"type":"string"}},"requireSan":{"default":true,"type":"boolean"},"cnMustBeInSan":{"default":true,"type":"boolean"},"allowedDomains":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["csrPem"],"additionalProperties":false},"example":{"csrPem":"-----BEGIN CERTIFICATE REQUEST-----\nMIICvDCCAaQCAQAwPTEYMBYGA1UEAwwPd3d3LmV4YW1wbGUuY29tMRQwEgYDVQQK\nDAtFeGFtcGxlIEx0ZDELMAkGA1UEBhMCR0IwggEiMA0GCSqGSIb3DQEBAQUAA4IB\nDwAwggEKAoIBAQCmAp8cymc6Y6IYvRHeNyoS4SukrpAqqwUxQfB93PTIlzM+dBe6\namfdgk72SVECDMMSPPXdBrYccGNopb05lOYrWjhsK1mtDGkPP/WHITp/7lOnZs/h\nYiPccdQW3XQTzyteQTNLBK2VW+RrxsdO4iy32yqN6JSUSFS1V69puX9X+Fk3i7Wj\nDzbo7aQ7vrt0jdt8MfalvHS04jWB9yGR6nih1Lq/rEHYPWEiv482rBQk6aJLXBQI\ncsuFLYZmipXgYcAENZEbuY4YIDVYRXuOnJ2aG3UnqOMyhEee+7x/Qb01hem3j/4+\nbvI6qxJiTqWbATZw9sDtppuT+0ZTC6RG/oQfAgMBAAGgOjA4BgkqhkiG9w0BCQ4x\nKzApMCcGA1UdEQQgMB6CD3d3dy5leGFtcGxlLmNvbYILZXhhbXBsZS5jb20wDQYJ\nKoZIhvcNAQELBQADggEBAB54LHsLSPKhOU0Ocfup3oI6wCjHU/VLM7cfEKb5grRD\n8dHd53Uqjzw/U1/+kzEEDJfjHhQrtOBhTNfB+g+fMON0mmNFfVzCEW+ByMlymqi2\n676YWeWRsYeq9/OoYjZvri/aBrTCcSZkZBekbYmihUJtZWSId0VZSVTfbx9DaYRE\n/PSw/KqE6pgcgg+V42JOsTGSECiiWZ1K1x5vJnwAViy0KheRFFcWF5320cl5Ptll\nEPdlG7O4eVhOD5oNhIKcTBoj61olXde6Rzvon8ZX8w/V3GV8Os+aTDd6pjjR3NAk\nOixP3BoF1J/fZpbJ5R2K54AJbtWdJ+pnBU1CwOmvRZE=\n-----END CERTIFICATE REQUEST-----\n","policy":{"minRsaBits":2048,"allowedKeyTypes":["RSA","EC"],"allowedCurves":["P-256","P-384"],"requireSan":true,"cnMustBeInSan":true,"allowedDomains":["example.com"]}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"subject":{"type":"string"},"publicKey":{"type":"object","properties":{"type":{"type":"string"},"bits":{"type":"number"}},"additionalProperties":true},"signatureAlgorithm":{"type":"string"},"signatureValid":{"type":"boolean"},"sans":{"type":"array","items":{"type":"string"}},"violations":{"type":"array","items":{}},"pass":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"subject":"CN=www.example.com,O=Example Ltd,C=GB","publicKey":{"type":"RSA","bits":2048},"signatureAlgorithm":"sha256WithRSAEncryption","signatureValid":true,"sans":["www.example.com","example.com"],"violations":[],"pass":true,"sources":[{"source":"Caller-supplied scan output, banners, certificates, rule sets or zone files processed locally","url":"https://www.brainiac.software/api/v1/network-exposure","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Pure computation on caller input: nothing is scanned, resolved or fetched at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/network-exposure/certificate-chain-build":{"post":{"operationId":"build_and_verify_a_certificate_chain_offline","summary":"Build and verify a certificate chain offline","description":"Chain certificates against the vendored Mozilla root store.","tags":["network-exposure"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"certificates":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","minLength":20}},"leafIndex":{"type":"integer","minimum":0,"maximum":19},"now":{"type":"string"}},"required":["certificates"],"additionalProperties":false},"example":{"certificates":["-----BEGIN CERTIFICATE-----\nMIIFBjCCAu6gAwIBAgIRAMISMktwqbSRcdxA9+KFJjwwDQYJKoZIhvcNAQELBQAw\nTzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh\ncmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMjQwMzEzMDAwMDAw\nWhcNMjcwMzEyMjM1OTU5WjAzMQswCQYDVQQGEwJVUzEWMBQGA1UEChMNTGV0J3Mg\nRW5jcnlwdDEMMAoGA1UEAxMDUjEyMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB\nCgKCAQEA2pgodK2+lP474B7i5Ut1qywSf+2nAzJ+Npfs6DGPpRONC5kuHs0BUT1M\n5ShuCVUxqqUiXXL0LQfCTUA83wEjuXg39RplMjTmhnGdBO+ECFu9AhqZ66YBAJpz\nkG2Pogeg0JfT2kVhgTU9FPnEwF9q3AuWGrCf4yrqvSrWmMebcas7dA8827JgvlpL\nThjp2ypzXIlhZZ7+7Tymy05v5J75AEaz/xlNKmOzjmbGGIVwx1Blbzt05UiDDwhY\nXS0jnV6j/ujbAKHS9OMZTfLuevYnnuXNnC2i8n+cF63vEzc50bTILEHWhsDp7CH4\nWRt/uTp8n1wBnWIEwii9Cq08yhDsGwIDAQABo4H4MIH1MA4GA1UdDwEB/wQEAwIB\nhjAdBgNVHSUEFjAUBggrBgEFBQcDAgYIKwYBBQUHAwEwEgYDVR0TAQH/BAgwBgEB\n/wIBADAdBgNVHQ4EFgQUALUp8i2ObzHom0yteD763OkM0dIwHwYDVR0jBBgwFoAU\nebRZ5nu25eQBc4AIiMgaWPbpm24wMgYIKwYBBQUHAQEEJjAkMCIGCCsGAQUFBzAC\nhhZodHRwOi8veDEuaS5sZW5jci5vcmcvMBMGA1UdIAQMMAowCAYGZ4EMAQIBMCcG\nA1UdHwQgMB4wHKAaoBiGFmh0dHA6Ly94MS5jLmxlbmNyLm9yZy8wDQYJKoZIhvcN\nAQELBQADggIBAI910AnPanZIZTKS3rVEyIV29BWEjAK/duuz8eL5boSoVpHhkkv3\n4eoAeEiPdZLj5EZ7G2ArIK+gzhTlRQ1q4FKGpPPaFBSpqV/xbUb5UlAXQOnkHn3m\nFVj+qYv87/WeY+Bm4sN3Ox8BhyaU7UAQ3LeZ7N1X01xxQe4wIAAE3JVLUCiHmZL+\nqoCUtgYIFPgcg350QMUIWgxPXNGEncT921ne7nluI02V8pLUmClqXOsCwULw+PVO\nZCB7qOMxxMBoCUeL2Ll4oMpOSr5pJCpLN3tRA2s6P1KLs9TSrVhOk+7LX28NMUlI\nusQ/nxLJID0RhAeFtPjyOCOscQBA53+NRjSCak7P4A5jX7ppmkcJECL+S0i3kXVU\ny5Me5BbrU8973jZNv/ax6+ZK6TM8jWmimL6of6OrX7ZU6E2WqazzsFrLG3o2kySb\nzlhSgJ81Cl4tv3SbYiYXnJExKQvzf83DYotox3f0fwv7xln1A2ZLplCb0O+l/AK0\nYE0DS2FPxSAHi0iwMfW2nNHJrXcY3LLHD77gRgje4Eveubi2xxa+Nmk/hmhLdIET\niVDFanoCrMVIpQ59XWHkzdFmoHXHBV7oibVjGSO7ULSQ7MJ1Nz51phuDJSgAIU7A\n0zrLnOrAj/dfrlEWRhCvAgbuwLZX1A2sjNjXoPOHbsPiy+lO1KF8/XY7\n-----END CERTIFICATE-----\n"],"now":"2026-11-14T00:00:00Z"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"array","items":{"type":"object","properties":{"subject":{"type":"string"},"sha256":{"type":"string"},"source":{"type":"string"}},"additionalProperties":true}},"trusted":{"type":"boolean"},"issues":{"type":"array","items":{}},"rootStore":{"type":"object","properties":{"source":{"type":"string"},"mozillaDataAsOf":{"type":"string"},"roots":{"type":"number"}},"additionalProperties":true},"revocationChecked":{"type":"boolean"},"evaluatedAt":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"chain":[{"subject":"C=US\nO=Let's Encrypt\nCN=R12","sha256":"131fce7784016899a5a00203a9efc80f18ebbd75580717edc1553580930836ec"},{"subject":"C=US\nO=Internet Security Research Group\nCN=ISRG Root X1","sha256":"96bcec06264976f37460779acf28c5a7cfe8a3c0aae11a8ffcee05c0bddf08c6","source":"mozilla_root_store"}],"trusted":true,"issues":[],"rootStore":{"source":"https://curl.se/ca/cacert.pem","mozillaDataAsOf":"2026-11-05T04:12:01Z","roots":118},"revocationChecked":false,"evaluatedAt":"2026-11-14T00:00:00Z","sources":[{"source":"Caller-supplied scan output, banners, certificates, rule sets or zone files processed locally","url":"https://www.brainiac.software/api/v1/network-exposure","retrievedAt":"2026-11-14","status":"ok"},{"source":"Mozilla CA bundle via curl cacert.pem (MPL-2.0)","url":"https://curl.se/ca/cacert.pem","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Pure computation on caller input: nothing is scanned, resolved or fetched at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/network-exposure/ssh-key-audit":{"post":{"operationId":"fingerprint_and_audit_ssh_public_keys","summary":"Fingerprint and audit SSH public keys","description":"Parse OpenSSH public keys, authorized_keys and certificates.","tags":["network-exposure"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"keys":{"minItems":1,"maxItems":10000,"type":"array","items":{"type":"string","minLength":1,"maxLength":16384}},"minRsaBits":{"default":2048,"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["keys"],"additionalProperties":false},"example":{"keys":["ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIH8wc0fgZaOfJhN0cBcLRJQ613oAtPc3euqmKSJy7dcR fixture@example"],"minRsaBits":2048}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"bits":{"type":"number"},"comment":{"type":"string"},"sha256":{"type":"string"},"md5":{"type":"string"},"options":{"type":"object","properties":{},"additionalProperties":true},"findings":{"type":"array","items":{}}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"results":[{"type":"ssh-ed25519","bits":256,"comment":"fixture@example","sha256":"SHA256:GqnVTPmakhybRC27iwQ39wDKYgDJNcZJ2egHdce9w24","md5":"MD5:8d:8f:4b:82:d3:a4:05:08:61:2c:52:05:fc:45:27:53","options":{},"findings":[]}],"sources":[{"source":"Caller-supplied scan output, banners, certificates, rule sets or zone files processed locally","url":"https://www.brainiac.software/api/v1/network-exposure","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Pure computation on caller input: nothing is scanned, resolved or fetched at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/network-exposure/nmap-xml-summarize":{"post":{"operationId":"summarise_nmap_xml_or_masscan_json","summary":"Summarise Nmap XML or Masscan JSON","description":"Turn scan output into host/service risk summaries.","tags":["network-exposure"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"format":{"type":"string","enum":["nmap_xml","masscan_json"]},"content":{"type":"string","minLength":1,"maxLength":5000000}},"required":["format","content"],"additionalProperties":false},"example":{"format":"nmap_xml","content":"<nmaprun><host><status state=\"up\"/><address addr=\"198.51.100.10\" addrtype=\"ipv4\"/><ports><port protocol=\"tcp\" portid=\"22\"><state state=\"open\"/><service name=\"ssh\" product=\"OpenSSH\" version=\"8.9p1\"/></port><port protocol=\"tcp\" portid=\"3389\"><state state=\"open\"/><service name=\"ms-wbt-server\"/></port><port protocol=\"tcp\" portid=\"25\"><state state=\"filtered\"/></port></ports></host><host><status state=\"down\"/><address addr=\"198.51.100.11\" addrtype=\"ipv4\"/></host></nmaprun>"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"hostsUp":{"type":"number"},"hostsDown":{"type":"number"},"openPorts":{"type":"number"},"byHost":{"type":"array","items":{"type":"object","properties":{"ip":{"type":"string"},"open":{"type":"array","items":{"type":"object","properties":{"port":{"type":"number"},"protocol":{"type":"string"},"service":{"type":"string"},"product":{"type":"string"},"version":{"type":"string"},"riskTier":{"type":"string"}},"additionalProperties":true}},"filtered":{"type":"number"}},"additionalProperties":true}},"byService":{"type":"object","properties":{"ssh":{"type":"number"},"ms-wbt-server":{"type":"number"}},"additionalProperties":true},"riskyServices":{"type":"array","items":{"type":"object","properties":{"ip":{"type":"string"},"port":{"type":"number"},"riskTier":{"type":"string"}},"additionalProperties":true}},"skippedHosts":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"hostsUp":1,"hostsDown":1,"openPorts":2,"byHost":[{"ip":"198.51.100.10","open":[{"port":22,"protocol":"tcp","service":"ssh","product":"OpenSSH","version":"8.9p1","riskTier":"medium"},{"port":3389,"protocol":"tcp","service":"ms-wbt-server","riskTier":"critical"}],"filtered":1}],"byService":{"ssh":1,"ms-wbt-server":1},"riskyServices":[{"ip":"198.51.100.10","port":3389,"riskTier":"critical"}],"skippedHosts":0,"sources":[{"source":"Caller-supplied scan output, banners, certificates, rule sets or zone files processed locally","url":"https://www.brainiac.software/api/v1/network-exposure","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Pure computation on caller input: nothing is scanned, resolved or fetched at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/network-exposure/port-service-risk-classify":{"post":{"operationId":"classify_port_service_exposure_risk","summary":"Classify port/service exposure risk","description":"Name IANA services and assign documented risk tiers.","tags":["network-exposure"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"services":{"minItems":1,"maxItems":100000,"type":"array","items":{"type":"object","properties":{"port":{"type":"integer","minimum":0,"maximum":65535},"protocol":{"type":"string","enum":["tcp","udp","sctp","dccp"]},"bannerHint":{"type":"string","maxLength":256}},"required":["port","protocol"],"additionalProperties":false}}},"required":["services"],"additionalProperties":false},"example":{"services":[{"port":3389,"protocol":"tcp"},{"port":22,"protocol":"tcp"},{"port":9200,"protocol":"tcp","bannerHint":"elasticsearch"},{"port":443,"protocol":"tcp"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":["object","string"],"properties":{"port":{"type":"number"},"protocol":{"type":"string"},"ianaServiceName":{"type":"string"},"riskTier":{"type":"string"},"rule":{"type":"string"}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"results":[{"port":3389,"protocol":"tcp","ianaServiceName":"ms-wbt-server","riskTier":"critical","rule":"remote_desktop"},{"port":22,"protocol":"tcp","ianaServiceName":"ssh","riskTier":"medium","rule":"remote_admin_encrypted"},"…"],"sources":[{"source":"Caller-supplied scan output, banners, certificates, rule sets or zone files processed locally","url":"https://www.brainiac.software/api/v1/network-exposure","retrievedAt":"2026-11-14","status":"ok"},{"source":"IANA Service Name and Transport Protocol Port Number Registry","url":"https://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.csv","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Pure computation on caller input: nothing is scanned, resolved or fetched at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/network-exposure/firewall-rule-analyze":{"post":{"operationId":"analyse_firewall_rules_for_anomalies","summary":"Analyse firewall rules for anomalies","description":"Find shadowed, redundant and overly permissive iptables/nftables/AWS SG rules.","tags":["network-exposure"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"format":{"type":"string","enum":["iptables","nftables","aws_sg"]},"rules":{"anyOf":[{"type":"string"},{"type":"array","items":{}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]},"sensitivePorts":{"anyOf":[{"type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},{"type":"null"}]}},"required":["format","rules"],"additionalProperties":false},"example":{"format":"iptables","rules":"-A INPUT -p tcp --dport 22 -j ACCEPT\n-A INPUT -p tcp -s 10.0.0.0/8 --dport 22 -j DROP\n-A INPUT -p tcp --dport 80 -j ACCEPT\n-A INPUT -p tcp -s 192.0.2.0/24 --dport 80 -j ACCEPT","sensitivePorts":null}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"findings":{"type":"array","items":{"type":["object","string"],"properties":{"rule":{"type":"number"},"type":{"type":"string"},"detail":{"type":"string"},"severity":{"type":"string"},"by":{"type":"number"}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"findings":[{"rule":1,"type":"overly_permissive","detail":"tcp/22 from any source","severity":"medium"},{"rule":2,"type":"shadowed","by":1,"detail":"never reached: rule 1 matches a superset with a different action"},"…"],"sources":[{"source":"Caller-supplied scan output, banners, certificates, rule sets or zone files processed locally","url":"https://www.brainiac.software/api/v1/network-exposure","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Pure computation on caller input: nothing is scanned, resolved or fetched at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/network-exposure/dns-zone-audit":{"post":{"operationId":"audit_a_bind_zone_file","summary":"Audit a BIND zone file","description":"Flag dangling CNAMEs, wildcards, missing CAA/SPF/DMARC and TTL anomalies.","tags":["network-exposure"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"zone":{"type":"string","minLength":1,"maxLength":5000000},"origin":{"type":"string","maxLength":255},"deprovisionedTargets":{"default":[],"maxItems":10000,"type":"array","items":{"type":"string","maxLength":255}},"minTtl":{"default":300,"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maxTtl":{"default":604800,"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["zone"],"additionalProperties":false},"example":{"zone":"$ORIGIN example.com.\n$TTL 3600\n@ IN SOA ns1 hostmaster 2026111401 7200 3600 1209600 300\n@ IN NS ns1\n@ IN MX 10 mail\n@ IN TXT \"v=spf1 mx -all\"\n* IN A 192.0.2.10\nold IN CNAME old-app.azurewebsites.net.\nwww 60 IN CNAME example.com.\nns1 IN A 192.0.2.1\nmail IN A 192.0.2.2","deprovisionedTargets":["old-app.azurewebsites.net"],"minTtl":300,"maxTtl":604800}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"origin":{"type":"string"},"records":{"type":"number"},"findings":{"type":"array","items":{"type":["object","string"],"properties":{"type":{"type":"string"},"name":{"type":"string"},"rrtype":{"type":"string"},"target":{"type":"string"}},"additionalProperties":true}},"spf":{"type":"object","properties":{"present":{"type":"boolean"},"record":{"type":"string"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"origin":"example.com.","records":9,"findings":[{"type":"wildcard_record","name":"*.example.com.","rrtype":"A"},{"type":"dangling_cname","name":"old.example.com.","target":"old-app.azurewebsites.net."},"…"],"spf":{"present":true,"record":"v=spf1 mx -all"},"sources":[{"source":"Caller-supplied scan output, banners, certificates, rule sets or zone files processed locally","url":"https://www.brainiac.software/api/v1/network-exposure","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Pure computation on caller input: nothing is scanned, resolved or fetched at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/network-exposure/dnssec-validate-offline":{"post":{"operationId":"validate_dnssec_records_offline","summary":"Validate DNSSEC records offline","description":"Check DNSKEY, DS and RRSIG material without network queries.","tags":["network-exposure"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"dnskeys":{"default":[],"maxItems":1000,"type":"array","items":{"type":"string"}},"ds":{"default":[],"maxItems":1000,"type":"array","items":{"type":"string"}},"rrset":{"default":[],"maxItems":1000,"type":"array","items":{"type":"string"}},"rrsigs":{"default":[],"maxItems":1000,"type":"array","items":{"type":"string"}},"now":{"type":"string"}},"additionalProperties":false},"example":{"dnskeys":["example.com. 3600 IN DNSKEY 257 3 15 l02Woi0iS8Aa25FQkUd9RMzZHJpBoRQwAQEX1SxZJA4="],"ds":["example.com. 3600 IN DS 3613 15 2 3aa5ab37efce57f737fc1627013fee07bdf241bd10f3b1964ab55c78e79a304b"],"rrset":["example.com. 3600 IN MX 10 mail.example.com."],"rrsigs":["example.com. 3600 IN RRSIG MX 15 2 3600 20150819220000 20150729220000 3613 example.com. oL9krJun7xfBOIWcGHi7mag5/hdZrKWw15jPGrHpjQeRAvTdszaPD+QLs3fx8A4M3e23mRZ9VrbpMngwcrqNAg=="],"now":"2015-08-08T02:13:20Z"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"object","properties":{"keyTag":{"type":"number"},"algorithm":{"type":"number"},"algorithmName":{"type":"string"},"flags":{"type":"number"},"sep":{"type":"boolean"},"dsMatch":{"type":"boolean"},"dsDigestType":{"type":"number"}},"additionalProperties":true}},"signatures":{"type":"array","items":{"type":"object","properties":{"covers":{"type":"string"},"keyTag":{"type":"number"},"valid":{"type":"boolean"},"inception":{"type":"string"},"expiration":{"type":"string"},"timeValid":{"type":"boolean"},"flags":{"type":"array","items":{}}},"additionalProperties":true}},"secure":{"type":"boolean"},"evaluatedAt":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"keys":[{"keyTag":3613,"algorithm":15,"algorithmName":"ED25519","flags":257,"sep":true,"dsMatch":true,"dsDigestType":2}],"signatures":[{"covers":"MX","keyTag":3613,"valid":true,"inception":"2015-07-29T22:00:00Z","expiration":"2015-08-19T22:00:00Z","timeValid":true,"flags":[]}],"secure":true,"evaluatedAt":"2015-08-08T02:13:20Z","sources":[{"source":"Caller-supplied scan output, banners, certificates, rule sets or zone files processed locally","url":"https://www.brainiac.software/api/v1/network-exposure","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Pure computation on caller input: nothing is scanned, resolved or fetched at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}