Corgi BankDocumentation
OpenAPI

Capture exact confidential account ownership and time coverage for an approved request and native candidate set

POST/accounts/information-requests/search

Confidential 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-KeystringOptional

Send 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 · dateRequired

A business date, YYYY-MM-DD

customer_idsarray of stringsOptional
cutoffstring · date-timeRequired
manifest_sha256stringRequired
purposestringRequired
request_idstringRequired

Example req_2tVh8nqLxq4GbDe0K1F6S9zRcWm

search_idstringRequired
sourcestringRequired

Customers, accounts or payments

subjectobjectRequired
9 child attributes
account_numbersarray of stringsOptional
addressesarray of objectsOptional
6 child attributes
citystringOptional
countrystringOptional
line1stringRequired
line2stringOptional
postal_codestringOptional
statestringOptional
date_of_birthstringOptional
identification_numbersarray of objectsOptional
3 child attributes
jurisdictionstringOptional
kindstringRequired
numberstringRequired
namesarray of stringsRequired
phonesarray of stringsOptional
referencestringRequired
routing_numbersarray of stringsOptional
tax_idsarray of stringsOptional
subject_referencestringRequired
transactions_fromstring · dateRequired

A business date, YYYY-MM-DD

Returns

200 OK

accountsarray of objectsRequired
11 child attributes
account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

closed_atstring · date-time or nullOptional
customer_idsarray of stringsRequired
matched_byarray of stringsRequired
numberstringRequired
numbersarray of stringsRequired
opened_atstring · date-timeRequired
ownersarray of objectsRequired
5 child attributes
backfilledbooleanOptional
customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

fromstring · date-timeRequired
rolestringRequired
tostring · date-time or nullOptional
ownership_revisionintegerRequired
source_sha256stringRequired
typestringRequired
accounts_fromstring · dateRequired

A business date, YYYY-MM-DD

algorithmstringRequired
candidatesarray of objectsRequired
4 child attributes
created_atstring · date-timeRequired
customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

matched_byarray of stringsRequired
source_sha256stringRequired
content_sha256stringRequired
cutoffstring · date-timeRequired
holesarray of stringsRequired
manifest_sha256stringRequired
purposestringRequired
query_sha256stringRequired
request_idstringRequired

Example req_2tVh8nqLxq4GbDe0K1F6S9zRcWm

rows_examinedintegerRequired
scan_completebooleanRequired
search_idstringRequired
snapshot_atstring · date-timeRequired
sourcestringRequired
subject_referencestringRequired
transactionsarray of objectsRequired
10 child attributes
account_idstringOptional

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

amount_minorintegerRequired
currencystringOptional
customer_idstringOptional

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

directionstringOptional
kindstringRequired
matched_byarray of stringsRequired
occurred_atstring · date-timeRequired
record_idstringRequired
source_sha256stringRequired
transactions_fromstring · dateRequired

A business date, YYYY-MM-DD

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503

to move to open esc to close