# Consumer Credit & Deposit Disclosures API > 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. Each paid operation uses a fixed USDC price on Base with the x402 exact scheme. Unpaid GET, HEAD, and POST return 402 payment terms (POST validates the body only after payment terms are satisfied). A request that carries payment-signature is not yet charged: settlement happens only after a successful (2xx) result. HTTP 4xx/5xx are not charged. Coverage bodies with status complete, partial, or failed all return HTTP 200 and are charged at the full listed price. Settled 2xx responses include a payment-response header; 4xx/5xx do not. Follow https://www.brainiac.software/agent-instructions.txt for install, payment pins, idempotency, and billing rules. - Product: https://www.brainiac.software/api/consumer-credit - Docs: https://www.brainiac.software/api/consumer-credit/docs - OpenAPI: https://www.brainiac.software/api/consumer-credit/openapi.json - Contact: support@brainiac.software (https://www.brainiac.software/contact) ## Operations ### POST /api/v1/consumer-credit/reg-z-apr $0.04 USDC. Compute the US closed-end credit APR with the Reg Z Appendix J actuarial method and optional disclosure tolerance check. Inputs: amountFinanced?, advanceDate?, advances?, payments, disclosedApr? Docs: https://www.brainiac.software/api/consumer-credit/docs#consumer-credit-reg-z-apr Example request: ```json { "amountFinanced": 500000, "advanceDate": "1978-01-10", "payments": [ { "amount": 23000, "count": 24, "firstDate": "1978-02-10", "frequency": "monthly" } ], "disclosedApr": 0.0969 } ``` Example response: ```json { "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).", "…" ] } ``` ### POST /api/v1/consumer-credit/uk-early-settlement $0.04 USDC. Compute the statutory minimum early-settlement rebate and settlement figure under the Consumer Credit (Early Settlement) Regulations 2004. Inputs: advances, repayments, apr, noticeReceivedDate?, settlementDate?, lastPaidInstalment?, deferral?, periodBasis?, treatLateAsOnTime?, partialSettlement? Docs: https://www.brainiac.software/api/consumer-credit/docs#consumer-credit-uk-early-settlement Example request: ```json { "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" } ``` Example response: ```json { "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." ] } ``` ### POST /api/v1/consumer-credit/apy-calculate $0.02 USDC. Compute annual percentage yield for US deposit disclosures under Reg DD Appendix A, including stepped and tiered rates. Inputs: mode, principal, interest, daysInTerm Docs: https://www.brainiac.software/api/consumer-credit/docs#consumer-credit-apy-calculate Example request: ```json { "mode": "interest", "principal": 100000, "interest": 6168, "daysInTerm": 365 } ``` Example response: ```json { "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." ] } ``` ### POST /api/v1/consumer-credit/pmi-termination-dates $0.03 USDC. Compute Homeowners Protection Act cancellation, automatic termination and final termination dates from the amortization schedule. Inputs: loanAmount, annualRate, termMonths, firstPaymentDate, salesPrice?, appraisedValue, purpose, monthlyPayment?, currentSchedule? Docs: https://www.brainiac.software/api/consumer-credit/docs#consumer-credit-pmi-termination-dates Example request: ```json { "loanAmount": 19000000, "annualRate": 0.06, "termMonths": 360, "firstPaymentDate": "2026-01-01", "salesPrice": 20000000, "appraisedValue": 20500000, "purpose": "purchase" } ``` Example response: ```json { "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." ] } ``` ### POST /api/v1/consumer-credit/reg-f-call-frequency $0.02 USDC. Check a debt-collector call log against the Reg F 7-in-7 presumption per debt. Inputs: debtId, calls, timezone? Docs: https://www.brainiac.software/api/consumer-credit/docs#consumer-credit-reg-f-call-frequency Example request: ```json { "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 } ] } ``` Example response: ```json { "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." ] } ```