{"openapi":"3.1.0","info":{"title":"AML Monitoring Thresholds & Deadlines API","version":"1.0.0","description":"CTR cash aggregation, structuring heuristics, rapid pass-through detection, and US SAR / UK POCA DAML deadline calendars on caller-supplied transaction and date inputs. 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/aml-monitoring/ctr-aggregate":{"post":{"operationId":"ctr_cash_aggregation","summary":"CTR cash aggregation","description":"Aggregate cash-in and cash-out per person per US business day and list totals that trigger a Currency Transaction Report.","tags":["aml-monitoring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"transactions":{"minItems":1,"maxItems":50000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":120},"personIds":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"direction":{"type":"string","enum":["in","out"]},"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"currency":{"default":"USD","type":"string","pattern":"^[A-Z]{3}$"},"postedDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"receivedAt":{"type":"string","minLength":8,"maxLength":64}},"required":["id","personIds","direction","amount"],"additionalProperties":false}},"businessDays":{"default":{"calendar":"US_FED"},"type":"object","properties":{"calendar":{"default":"US_FED","type":"string","enum":["US_FED"]}},"additionalProperties":false},"regime":{"default":"US_CTR","type":"string","enum":["US_CTR","custom"]},"threshold":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"nearRatio":{"default":0.8,"type":"number","minimum":0.1,"maximum":1}},"required":["transactions"],"additionalProperties":false},"example":{"transactions":[{"id":"t1","personIds":["P1"],"direction":"in","amount":600000,"currency":"USD","postedDate":"2026-11-13"},{"id":"t2","personIds":["P1"],"direction":"in","amount":400001,"currency":"USD","postedDate":"2026-11-13"}]}}}},"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":{"reportable":{"type":"array","items":{"type":"object","properties":{"personId":{"type":"string"},"businessDay":{"type":"string"},"direction":{"type":"string"},"total":{"type":"number"},"transactionIds":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"nearThreshold":{"type":"array","items":{}},"threshold":{"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":{"reportable":[{"personId":"P1","businessDay":"2026-11-13","direction":"in","total":1000001,"transactionIds":["t1","t2"]}],"nearThreshold":[],"threshold":1000000,"sources":[{"source":"31 CFR 1010.311 / 1010.313","url":"https://www.ecfr.gov/current/title-31/subtitle-B/chapter-X/part-1010/subpart-C/section-1010.311","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Aggregation uses only the person links the caller supplies (1010.313 requires knowledge).","Cash-in and cash-out are not netted.","…"]}}}},"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/aml-monitoring/structuring-detect":{"post":{"operationId":"cash_structuring_heuristic","summary":"Cash structuring heuristic","description":"Flag repeated just-below-threshold cash deposits as a structuring heuristic for analyst review.","tags":["aml-monitoring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"transactions":{"minItems":1,"maxItems":50000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":120},"personIds":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"direction":{"type":"string","enum":["in","out"]},"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"currency":{"default":"USD","type":"string","pattern":"^[A-Z]{3}$"},"postedDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"receivedAt":{"type":"string","minLength":8,"maxLength":64}},"required":["id","personIds","direction","amount"],"additionalProperties":false}},"params":{"default":{"windowDays":7,"lowerRatio":0.8,"minCount":3,"minTotalRatio":1},"type":"object","properties":{"windowDays":{"default":7,"type":"integer","minimum":1,"maximum":30},"lowerRatio":{"default":0.8,"type":"number","minimum":0.5,"maximum":0.99},"minCount":{"default":3,"type":"integer","minimum":1,"maximum":100},"minTotalRatio":{"default":1,"type":"number","minimum":0.1,"maximum":10}},"additionalProperties":false}},"required":["transactions"],"additionalProperties":false},"example":{"transactions":[{"id":"a","personIds":["P1"],"direction":"in","amount":950000,"currency":"USD","postedDate":"2026-11-02"},{"id":"b","personIds":["P1"],"direction":"in","amount":950000,"currency":"USD","postedDate":"2026-11-04"},{"id":"c","personIds":["P1"],"direction":"in","amount":950000,"currency":"USD","postedDate":"2026-11-06"}]}}}},"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":{"alerts":{"type":"array","items":{"type":"object","properties":{"personId":{"type":"string"},"windowStart":{"type":"string"},"windowEnd":{"type":"string"},"count":{"type":"number"},"total":{"type":"number"},"transactionIds":{"type":"array","items":{"type":"string"}},"pattern":{"type":"string"},"noCtrTriggered":{"type":"boolean"}},"additionalProperties":true}},"params":{"type":"object","properties":{"windowDays":{"type":"number"},"lowerRatio":{"type":"number"},"minCount":{"type":"number"},"minTotalRatio":{"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":{"alerts":[{"personId":"P1","windowStart":"2026-11-02","windowEnd":"2026-11-08","count":3,"total":2850000,"transactionIds":["a","b","…"],"pattern":"repeated_just_below_threshold","noCtrTriggered":true}],"params":{"windowDays":7,"lowerRatio":0.8,"minCount":3,"minTotalRatio":1},"sources":[{"source":"31 U.S.C. 5324 / 31 CFR 1010.311","url":"https://www.law.cornell.edu/uscode/text/31/5324","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Heuristic for review; structuring requires intent (31 U.S.C. 5324).","Not legal advice. Outputs are lookups or prechecks for human review."]}}}},"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/aml-monitoring/rapid-movement-detect":{"post":{"operationId":"rapid_pass_through_detection","summary":"Rapid pass-through detection","description":"Detect credits quickly followed by similar-sized debits as a money-mule pass-through indicator on caller data.","tags":["aml-monitoring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"accountId":{"type":"string","minLength":1,"maxLength":120},"transactions":{"minItems":1,"maxItems":50000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":120},"direction":{"type":"string","enum":["in","out"]},"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"at":{"type":"string","minLength":8,"maxLength":64},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"counterparty":{"type":"string","maxLength":120}},"required":["id","direction","amount","at"],"additionalProperties":false}},"params":{"default":{"maxHours":48,"minOutRatio":0.9,"minAmount":100000},"type":"object","properties":{"maxHours":{"default":48,"type":"number","minimum":1,"maximum":720},"minOutRatio":{"default":0.9,"type":"number","minimum":0.5,"maximum":1},"minAmount":{"default":100000,"type":"integer","minimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["accountId","transactions"],"additionalProperties":false},"example":{"accountId":"A1","transactions":[{"id":"c1","direction":"in","amount":500000,"at":"2026-11-10T09:00:00Z"},{"id":"d1","direction":"out","amount":300000,"at":"2026-11-10T12:00:00Z"},{"id":"d2","direction":"out","amount":170000,"at":"2026-11-11T05:30: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":{"accountId":{"type":"string"},"matches":{"type":"array","items":{"type":"object","properties":{"creditId":{"type":"string"},"debitIds":{"type":"array","items":{"type":"string"}},"creditAmount":{"type":"number"},"debitTotal":{"type":"number"},"ratio":{"type":"number"},"hoursToExit":{"type":"number"}},"additionalProperties":true}},"summary":{"type":"object","properties":{"credits":{"type":"number"},"matched":{"type":"number"},"passThroughRatio":{"type":"number"}},"additionalProperties":true},"params":{"type":"object","properties":{"maxHours":{"type":"number"},"minOutRatio":{"type":"number"},"minAmount":{"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":{"accountId":"A1","matches":[{"creditId":"c1","debitIds":["d1","d2"],"creditAmount":500000,"debitTotal":470000,"ratio":0.94,"hoursToExit":20.5}],"summary":{"credits":1,"matched":1,"passThroughRatio":0.94},"params":{"maxHours":48,"minOutRatio":0.9,"minAmount":100000},"sources":[{"source":"Caller-supplied ledger pass-through heuristic","url":"https://www.brainiac.software","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Indicator only.","Not legal advice. Outputs are lookups or prechecks for human review."]}}}},"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/aml-monitoring/sar-deadline":{"post":{"operationId":"sar_daml_deadline_calendar","summary":"SAR / DAML deadline calendar","description":"Compute US bank SAR filing deadlines or UK POCA s.335 notice and moratorium periods from vendored holiday calendars.","tags":["aml-monitoring"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"regime":{"type":"string","const":"US_BANK_SAR"},"initialDetection":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"suspectIdentified":{"default":true,"type":"boolean"}},"required":["regime","initialDetection"],"additionalProperties":false},{"type":"object","properties":{"regime":{"type":"string","const":"UK_POCA_335"},"disclosureDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"ukRegion":{"default":"england-and-wales","type":"string","enum":["england-and-wales","scotland","northern-ireland"]},"refusalNoticeDate":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]}},"required":["regime","disclosureDate"],"additionalProperties":false}]},"example":{"regime":"US_BANK_SAR","initialDetection":"2026-11-02","suspectIdentified":false}}}},"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":{"deadline":{"type":"string"},"extendedDeadline":{"type":"string"},"maxDeadline":{"type":"string"},"reportingThresholdInfo":{"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":{"deadline":"2026-12-02","extendedDeadline":"2027-01-01","maxDeadline":"2027-01-01","reportingThresholdInfo":500000,"sources":[{"source":"31 CFR 1020.320(b)(3)","url":"https://www.ecfr.gov/current/title-31/subtitle-B/chapter-X/part-1020/subpart-C/section-1020.320","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["US bank SAR filing deadline computation only; does not assess whether a SAR is required.","Not legal advice. Outputs are lookups or prechecks for human review."]}}}},"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"}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}