Capture request-bound native customer, deposit account, transaction and credit account cuts with durable recovery and explicit coverage holes
/bsa-filings/information-requests/{request_id}/searchesConfidential 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.
Path parameters
request_idstringRequiredHeaders
Idempotency-KeystringRequiredSend on every write that creates or changes money or state; a replay with the same key returns the original result with 200.
Body parameters
content_sha256stringRequiredplan_versionintegerRequiredReturns
200 OK
actorstringRequiredatstring · date-timeRequiredcompletedbooleanRequiredcontent_sha256stringRequiredholesarray of stringsRequiredidstringRequiredmatchesarray of objectsRequired8 child attributes
actorstringRequiredatstring · date-timeRequiredbasis_sha256stringRequiredcustomer_idstringOptionalExample cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm
decisionstringRequiredkindstringOptionalrecord_idstringOptionalsubject_referencestringRequiredpageobjectRequiredInformationPage windows the evidence items of a search in their retained order (subject, then source, then item); keys are zero-padded ordinals.
7 child attributes
ending_beforestringOptionalfirst_keystringOptionalhas_morebooleanRequireditemsintegerRequiredlast_keystringOptionallimitintegerRequiredstarting_afterstringOptionalpendingarray of objectsRequired4 child attributes
customer_idstringOptionalExample cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm
kindstringOptionalrecord_idstringOptionalsubject_referencestringRequiredplan_versionintegerRequiredrequest_idstringRequiredExample req_2tVh8nqLxq4GbDe0K1F6S9zRcWm
sourcesarray of objectsRequired6 child attributes
accountsintegerRequiredcandidatesintegerRequiredresultobjectRequired19 child attributes
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 objectsRequiredownership_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
sourcestringRequiredsubject_referencestringRequiredtransactionsintegerRequiredstagestringRequiredErrors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503