Capture exact confidential loan and facility evidence for an approved request, its candidate set and the subject's own account numbers inside the original account window
/loans/information-requests/searchConfidential bounded 314(a) request custody. Actual svc_bsa_bridge and separately configured environment-bound information_request signature authority admit exact original portal bytes plus extracted manifest (names, US tax identifiers, date of birth, addresses, phones, typed identification numbers, account and routing numbers); no FinCEN signature or live portal adapter is claimed. Two staff members review the original and exact plan before request-bound source queries. Four planned native sources cut the core under one explicit normalization: customers (current, evidenced historical, as-filed and tax-document identities, keyed tax blind index or the salted hash on records without one, corrected-tax hashes, tokenized names as lower-confidence candidates, date of birth as confirmation), accounts (every deposit account in the window, current and former owners from database-maintained ownership history, every account number, the subject's own account numbers), payments (wires, instant payments, ACH transfers and receipts, official checks, check deposits, lockbox and inclearing items, saved counterparties inside the transaction window) and lending (loans and facilities, the credit accounts 31 CFR 1010.505(a) counts as accounts, by candidate borrower or the subject's own account numbers). Each verifies exact planned query authority with compliance using the actual incoming svc_compliance token and existing scopes only. Cuts, decisions and handoffs are immutable, purpose-audited and excluded from general bank/customer discovery; the review view pages evidence items. A search is complete only when every source scanned its whole cut with no declared hole. A complete search with independent decisions on every candidate yields a response_ready handoff of positive evidence, or a no_match_recorded handoff with the exact identifiers, windows, row counts and hashes searched and no reply, because FinCEN instructs no reply without a match. Positives under a declared hole or an unresolved decision are partial_coverage. Passport, licence and other document numbers, which no native customer record retains, are an explicit hole. Nothing transmits: the handoff stays not_transmitted and never submission_ready; the BSA officer reports positives through the FinCEN portal by hand.
Headers
Idempotency-KeystringOptionalSend on every write that creates or changes money or state; a replay with the same key returns the original result with 200.
Body parameters
accounts_fromstring · dateRequiredA business date, YYYY-MM-DD
customer_idsarray of stringsOptionalcutoffstring · date-timeRequiredmanifest_sha256stringRequiredpurposestringRequiredrequest_idstringRequiredExample req_2tVh8nqLxq4GbDe0K1F6S9zRcWm
search_idstringRequiredsourcestringRequiredCustomers, accounts or payments
subjectobjectRequired9 child attributes
account_numbersarray of stringsOptionaladdressesarray of objectsOptional6 child attributes
citystringOptionalcountrystringOptionalline1stringRequiredline2stringOptionalpostal_codestringOptionalstatestringOptionaldate_of_birthstringOptionalidentification_numbersarray of objectsOptional3 child attributes
jurisdictionstringOptionalkindstringRequirednumberstringRequirednamesarray of stringsRequiredphonesarray of stringsOptionalreferencestringRequiredrouting_numbersarray of stringsOptionaltax_idsarray of stringsOptionalsubject_referencestringRequiredtransactions_fromstring · dateRequiredA business date, YYYY-MM-DD
Returns
200 OK
accountsarray of objectsRequired11 child attributes
account_idstringRequiredExample acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm
closed_atstring · date-time or nullOptionalcustomer_idsarray of stringsRequiredmatched_byarray of stringsRequirednumberstringRequirednumbersarray of stringsRequiredopened_atstring · date-timeRequiredownersarray of objectsRequired5 child attributes
backfilledbooleanOptionalcustomer_idstringRequiredExample cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm
fromstring · date-timeRequiredrolestringRequiredtostring · date-time or nullOptionalownership_revisionintegerRequiredsource_sha256stringRequiredtypestringRequiredaccounts_fromstring · dateRequiredA business date, YYYY-MM-DD
algorithmstringRequiredcandidatesarray of objectsRequired4 child attributes
created_atstring · date-timeRequiredcustomer_idstringRequiredExample cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm
matched_byarray of stringsRequiredsource_sha256stringRequiredcontent_sha256stringRequiredcutoffstring · date-timeRequiredholesarray of stringsRequiredmanifest_sha256stringRequiredpurposestringRequiredquery_sha256stringRequiredrequest_idstringRequiredExample req_2tVh8nqLxq4GbDe0K1F6S9zRcWm
rows_examinedintegerRequiredscan_completebooleanRequiredsearch_idstringRequiredsnapshot_atstring · date-timeRequiredsourcestringRequiredsubject_referencestringRequiredtransactionsarray of objectsRequired10 child attributes
account_idstringOptionalExample acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm
amount_minorintegerRequiredcurrencystringOptionalcustomer_idstringOptionalExample cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm
directionstringOptionalkindstringRequiredmatched_byarray of stringsRequiredoccurred_atstring · date-timeRequiredrecord_idstringRequiredsource_sha256stringRequiredtransactions_fromstring · dateRequiredA business date, YYYY-MM-DD
Errors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503