{"openapi":"3.1.0","info":{"title":"Consumer Credit & Deposit Disclosures API","version":"1.0.0","description":"Reg Z APR (Appendix J), UK early-settlement rebate, Reg DD APY, HPA PMI termination dates, and Reg F call-frequency presumptions from caller-supplied loan and call data. 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/consumer-credit/reg-z-apr":{"post":{"operationId":"regulation_z_apr_appendix_j","summary":"Regulation Z APR (Appendix J)","description":"Compute the US closed-end credit APR with the Reg Z Appendix J actuarial method and optional disclosure tolerance check.","tags":["consumer-credit"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"amountFinanced":{"type":"integer","minimum":1,"maximum":9007199254740991},"advanceDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"advances":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"amount":{"type":"integer","minimum":1,"maximum":9007199254740991},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["amount","date"],"additionalProperties":false}},"payments":{"anyOf":[{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"amount":{"type":"integer","minimum":1,"maximum":9007199254740991},"count":{"type":"integer","minimum":1,"maximum":1200},"firstDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"frequency":{"type":"string","enum":["monthly","semimonthly","weekly","biweekly","quarterly","semiannual","annual"]}},"required":["amount","count","firstDate","frequency"],"additionalProperties":false}},{"minItems":1,"maxItems":1200,"type":"array","items":{"type":"object","properties":{"amount":{"type":"integer","minimum":1,"maximum":9007199254740991},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["amount","date"],"additionalProperties":false}}]},"disclosedApr":{"type":"number","minimum":0,"maximum":10}},"required":["payments"],"additionalProperties":false},"example":{"amountFinanced":500000,"advanceDate":"1978-01-10","payments":[{"amount":23000,"count":24,"firstDate":"1978-02-10","frequency":"monthly"}],"disclosedApr":0.0969}}}},"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":{"apr":{"type":"number"},"aprExact":{"type":"number"},"unitPeriod":{"type":"string"},"unitPeriodsPerYear":{"type":"number"},"firstPeriod":{"type":"object","properties":{"t":{"type":"number"},"f":{"type":"number"}},"additionalProperties":true},"withinTolerance":{"type":"boolean"},"tolerance":{"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":{"apr":0.0969,"aprExact":0.0968570806228084,"unitPeriod":"month","unitPeriodsPerYear":12,"firstPeriod":{"t":1,"f":0},"withinTolerance":true,"tolerance":0.00125,"sources":[{"source":"12 CFR Part 1026 Appendix J","url":"https://www.ecfr.gov/current/title-12/chapter-X/part-1026/appendix-Appendix%20J%20to%20Part%201026","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Actuarial method per Appendix J; disclosure APR is rounded to two decimal places of percent.","Tolerance uses 12 CFR 1026.22(a)(2)/(a)(3).","…"]}}}},"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/consumer-credit/uk-early-settlement":{"post":{"operationId":"uk_early_settlement_rebate","summary":"UK early settlement rebate","description":"Compute the statutory minimum early-settlement rebate and settlement figure under the Consumer Credit (Early Settlement) Regulations 2004.","tags":["consumer-credit"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"advances":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"amount":{"type":"integer","minimum":1,"maximum":9007199254740991},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["amount","date"],"additionalProperties":false}},"repayments":{"anyOf":[{"type":"object","properties":{"amount":{"type":"integer","minimum":1,"maximum":9007199254740991},"count":{"type":"integer","minimum":1,"maximum":1200},"firstDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"frequency":{"type":"string","enum":["monthly","semimonthly","weekly","biweekly","quarterly","semiannual","annual"]}},"required":["amount","count","firstDate","frequency"],"additionalProperties":false},{"minItems":1,"maxItems":1200,"type":"array","items":{"type":"object","properties":{"amount":{"type":"integer","minimum":1,"maximum":9007199254740991},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["amount","date"],"additionalProperties":false}}]},"apr":{"type":"number","exclusiveMinimum":0,"maximum":10},"noticeReceivedDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"settlementDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"lastPaidInstalment":{"type":"integer","minimum":0,"maximum":1200},"deferral":{"default":"none","type":"string","enum":["none","one_month","30_days"]},"periodBasis":{"default":"month","type":"string","enum":["month"]},"treatLateAsOnTime":{"default":true,"type":"boolean"},"partialSettlement":{"default":false,"type":"boolean"}},"required":["advances","repayments","apr"],"additionalProperties":false},"example":{"advances":[{"amount":500000,"date":"2025-01-01"}],"repayments":{"amount":13457,"count":48,"firstDate":"2025-02-01","frequency":"monthly"},"apr":0.14,"noticeReceivedDate":"2026-01-01","lastPaidInstalment":12,"deferral":"none"}}}},"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":{"settlementDate":{"type":"string"},"periodRate":{"type":"number"},"outstandingAtLastInstalment":{"type":"number"},"settlementFigure":{"type":"number"},"remainingRepaymentsTotal":{"type":"number"},"rebate":{"type":"number"},"fractionConvention":{"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":{"settlementDate":"2026-01-29","periodRate":0.010978851950173452,"outstandingAtLastInstalment":398400,"settlementFigure":402348,"remainingRepaymentsTotal":484452,"rebate":82104,"fractionConvention":"whole_months_plus_days_over_days_in_month","sources":[{"source":"Consumer Credit (Early Settlement) Regulations 2004 SI 2004/1483","url":"https://www.legislation.gov.uk/uksi/2004/1483/made","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Uses unrounded periodic rate r = (1+APR)^(1/12)−1. Partial early settlement is not supported.","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.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/consumer-credit/apy-calculate":{"post":{"operationId":"regulation_dd_apy","summary":"Regulation DD APY","description":"Compute annual percentage yield for US deposit disclosures under Reg DD Appendix A, including stepped and tiered rates.","tags":["consumer-credit"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"mode":{"type":"string","const":"interest"},"principal":{"type":"integer","minimum":1,"maximum":9007199254740991},"interest":{"type":"integer","minimum":0,"maximum":9007199254740991},"daysInTerm":{"default":365,"type":"integer","minimum":1,"maximum":3660},"yearBasis":{"default":365,"anyOf":[{"type":"number","const":365},{"type":"number","const":366}]}},"required":["mode","principal","interest"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"rates"},"principal":{"type":"integer","minimum":1,"maximum":9007199254740991},"daysInTerm":{"type":"integer","minimum":1,"maximum":3660},"compounding":{"default":"daily","type":"string","enum":["daily","monthly","quarterly"]},"steps":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"rate":{"type":"number","minimum":0,"maximum":1},"days":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["rate","days"],"additionalProperties":false}},"yearBasis":{"default":365,"anyOf":[{"type":"number","const":365},{"type":"number","const":366}]}},"required":["mode","principal","daysInTerm","steps"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"tiered"},"method":{"type":"string","enum":["A","B"]},"tiers":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"upTo":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"rate":{"type":"number","minimum":0,"maximum":1}},"required":["upTo","rate"],"additionalProperties":false}},"assumedMaxBalance":{"type":"integer","minimum":1,"maximum":9007199254740991},"compounding":{"default":"daily","type":"string","enum":["daily"]},"yearBasis":{"default":365,"anyOf":[{"type":"number","const":365},{"type":"number","const":366}]}},"required":["mode","method","tiers","assumedMaxBalance"],"additionalProperties":false}]},"example":{"mode":"interest","principal":100000,"interest":6168,"daysInTerm":365}}}},"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":{"apy":{"type":"number"},"apyExact":{"type":"number"},"interest":{"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":{"apy":0.0617,"apyExact":0.06168,"interest":6168,"sources":[{"source":"12 CFR Part 1030 Appendix A","url":"https://www.ecfr.gov/current/title-12/chapter-X/part-1030/appendix-Appendix%20A%20to%20Part%201030","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["APY rounded to two decimals of percent for disclosure.","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"}}},"/api/v1/consumer-credit/pmi-termination-dates":{"post":{"operationId":"hpa_pmi_termination_dates","summary":"HPA PMI termination dates","description":"Compute Homeowners Protection Act cancellation, automatic termination and final termination dates from the amortization schedule.","tags":["consumer-credit"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"loanAmount":{"type":"integer","minimum":1,"maximum":9007199254740991},"annualRate":{"type":"number","minimum":0,"maximum":1},"termMonths":{"type":"integer","minimum":12,"maximum":600},"firstPaymentDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"salesPrice":{"type":"integer","minimum":1,"maximum":9007199254740991},"appraisedValue":{"type":"integer","minimum":1,"maximum":9007199254740991},"purpose":{"type":"string","enum":["purchase","refinance"]},"monthlyPayment":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"currentSchedule":{"maxItems":600,"type":"array","items":{"type":"object","properties":{"paymentNumber":{"type":"integer","minimum":1,"maximum":9007199254740991},"balance":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["paymentNumber","balance"],"additionalProperties":false}}},"required":["loanAmount","annualRate","termMonths","firstPaymentDate","appraisedValue","purpose"],"additionalProperties":false},"example":{"loanAmount":19000000,"annualRate":0.06,"termMonths":360,"firstPaymentDate":"2026-01-01","salesPrice":20000000,"appraisedValue":20500000,"purpose":"purchase"}}}},"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":{"originalValue":{"type":"number"},"monthlyPayment":{"type":"number"},"cancellationDate":{"type":"string"},"cancellationPaymentNumber":{"type":"number"},"terminationDate":{"type":"string"},"terminationPaymentNumber":{"type":"number"},"finalTerminationDate":{"type":"string"},"midpointPaymentNumber":{"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":{"originalValue":20000000,"monthlyPayment":113915,"cancellationDate":"2035-10-01","cancellationPaymentNumber":118,"terminationDate":"2036-09-01","terminationPaymentNumber":129,"finalTerminationDate":"2041-01-01","midpointPaymentNumber":180,"sources":[{"source":"12 U.S.C. 4901–4902 (Homeowners Protection Act)","url":"https://www.law.cornell.edu/uscode/text/12/4902","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Borrower cancellation also requires the conditions in 12 U.S.C. 4902(a).","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/consumer-credit/reg-f-call-frequency":{"post":{"operationId":"regulation_f_call_frequency_check","summary":"Regulation F call-frequency check","description":"Check a debt-collector call log against the Reg F 7-in-7 presumption per debt.","tags":["consumer-credit"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"debtId":{"type":"string","minLength":1,"maxLength":120},"calls":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"at":{"type":"string","minLength":8,"maxLength":64},"connected":{"default":false,"type":"boolean"},"excluded":{"default":false,"type":"boolean"},"consentGivenAt":{"type":"string","minLength":8,"maxLength":64}},"required":["at"],"additionalProperties":false}},"timezone":{"default":"America/New_York","type":"string","minLength":1,"maxLength":64}},"required":["debtId","calls"],"additionalProperties":false},"example":{"debtId":"D1","timezone":"America/New_York","calls":[{"at":"2026-11-02T10:00:00-05:00","connected":false},{"at":"2026-11-03T10:00:00-05:00","connected":false},{"at":"2026-11-04T10:00:00-05:00","connected":false},{"at":"2026-11-05T10:00:00-05:00","connected":false},{"at":"2026-11-06T10:00:00-05:00","connected":false},{"at":"2026-11-07T10:00:00-05:00","connected":false},{"at":"2026-11-08T10:00:00-05:00","connected":false},{"at":"2026-11-08T11:00:00-05:00","connected":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":{"debtId":{"type":"string"},"presumedViolation":{"type":"boolean"},"violations":{"type":"array","items":{"type":"object","properties":{"rule":{"type":"string"},"windowStart":{"type":"string"},"windowEnd":{"type":"string"},"calls":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string"},"day":{"type":"string"}},"additionalProperties":true}}},"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":{"debtId":"D1","presumedViolation":true,"violations":[{"rule":"1006.14(b)(2)(i)(B)","windowStart":"2026-11-02","windowEnd":"2026-11-08","calls":[{"at":"2026-11-08T10:00:00-05:00","day":"2026-11-08"}]}],"sources":[{"source":"12 CFR 1006.14(b)(2)","url":"https://www.ecfr.gov/current/title-12/chapter-X/part-1006/section-1006.14","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Presumption only; the rule's other factors and the (b)(3) exclusions are the caller's responsibility to flag.","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":{}}}}}}}}