Corgi BankDocumentation
OpenAPI

Record legal process with its basis evidence and scope, and open its first production with automatic archive holds

POST/bank-records/legal-requests

Reviewed legal production under the dedicated records:bank staff authority with step-up within five minutes; records:bank:approve decides a package and records determinations, and a decision or determination refuses everyone who shaped the production: its legal request's opener, maker, collector, item reviewers, review completer and packager. Intake retains the process, its legal basis evidence and, for a government authority or bank regulator, the bank's Right to Financial Privacy Act determination (12 U.S.C. 3403(b)); it places automatic archive holds that cannot be released while the production is open, and a scope naming no family must acknowledge the bank-wide hold it places. Collection freezes exact hashes; BSA-confidential families and documents in scope are excluded automatically and logged internally only, and a SAR or material revealing one is never produced, numbered, manifested or privilege-logged (31 CFR 1020.320(e)). Every collected item takes one reviewer decision before review closes (text matching a SAR indicator, unscanned binary content and incomplete captures are flagged and decided individually; a page of at most 200 unflagged items may be cleared in one decision); nothing is produced by default. Release needs the independent approval, the recorded notices (FinCEN under 31 CFR 1020.320(e)(1)(i) and the OCC Litigation Division under 12 CFR 21.11(k)(1)(i)(A) for any BSA withholding; the OCC Litigation Division under 12 CFR 4.37(b)(3)(i) when non-public OCC information was withheld), the counsel named at intake, and returns the package key to the releasing staff member; nothing is transmitted.

Headers

Idempotency-KeystringRequired

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

basisobjectRequired

LegalBasis is the retained evidence of the process itself. The code decides no legal question: validity, privilege, confidentiality and Right to Financial Privacy Act determinations are the bank's, evidenced here.

4 child attributes
citationstringRequired
evidence_refstringRequired
evidence_sha256stringRequired
reasonstringRequired
counselstringRequired
issuing_authoritystringRequired
kindstringRequired

Subpoena, court_order or regulator_request

matter_refstringRequired
production_prefixstringRequired
purposestringRequired
received_atstring · date-timeRequired
requester_typestringRequired

Private_party, court, government_authority or bank_regulator

response_due_atstring · date-time or nullOptional
rfpaobject or nullOptional

RFPADetermination records the bank's determination for a government authority's request: the written certificate of compliance 12 U.S.C. 3403(b) requires before customer financial records are released, or the evidenced determination that the certificate does not apply.

4 child attributes
determinationstringRequired

Certificate_received or not_applicable

evidence_refstringRequired
evidence_sha256stringRequired
reasonstringRequired
scopeobjectRequired

LegalScope selects what a production collects. Every named dimension must match; within a dimension any listed value matches. Families name registered sources, RetainedRecords or ExternalDocuments; no families means every archive family, which the request must acknowledge with BankWide and its reason, because that places a bank-wide hold: every registered connector starts retaining superseded rows in its own database until the hold is released.

8 child attributes
account_idsarray of stringsRequired
bank_widebooleanOptional
bank_wide_reasonstringOptional
custodiansarray of stringsRequired
customer_idsarray of stringsRequired
familiesarray of objectsRequired
2 child attributes
servicestringRequired
sourcestringRequired
fromstring · date-time or nullOptional
throughstring · date-time or nullOptional

Returns

200 OK

actorstringRequired
created_atstring · date-timeRequired
idstringRequired
productionsarray of objectsRequired
16 child attributes
actorstringRequired
approved_bystringOptional
created_atstring · date-timeRequired
high_waterintegerOptional
holdsarray of objectsRequired
5 child attributes
bank_widebooleanOptional
customer_idstringOptional

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

hold_idstringRequired

Example hold_2tVh8nqLxq4GbDe0K1F6S9zRcWm

kindstringRequired

Bank_archive or customer_archive

targetobjectRequired
2 child attributes
servicestringRequired
sourcestringRequired
idstringRequired
itemsintegerRequired
legal_request_idstringRequired

Example req_2tVh8nqLxq4GbDe0K1F6S9zRcWm

packageobject or nullOptional
7 child attributes
first_numberstringOptional
last_numberstringOptional
manifest_sha256stringRequired
package_sha256stringRequired
packaged_atstring · date-timeRequired
packaged_bystringRequired
partsintegerRequired
released_atstring · date-time or nullOptional
required_determinationsarray of stringsRequired
review_requiredintegerRequired
root_sha256stringOptional
scopeobjectRequired

LegalScope selects what a production collects. Every named dimension must match; within a dimension any listed value matches. Families name registered sources, RetainedRecords or ExternalDocuments; no families means every archive family, which the request must acknowledge with BankWide and its reason, because that places a bank-wide hold: every registered connector starts retaining superseded rows in its own database until the hold is released.

8 child attributes
account_idsarray of stringsRequired
bank_widebooleanOptional
bank_wide_reasonstringOptional
custodiansarray of stringsRequired
customer_idsarray of stringsRequired
familiesarray of objectsRequired
2 child attributes
servicestringRequired
sourcestringRequired
fromstring · date-time or nullOptional
throughstring · date-time or nullOptional
sequenceintegerRequired
statusstringRequired
requestobjectRequired
12 child attributes
basisobjectRequired

LegalBasis is the retained evidence of the process itself. The code decides no legal question: validity, privilege, confidentiality and Right to Financial Privacy Act determinations are the bank's, evidenced here.

4 child attributes
citationstringRequired
evidence_refstringRequired
evidence_sha256stringRequired
reasonstringRequired
counselstringRequired
issuing_authoritystringRequired
kindstringRequired

Subpoena, court_order or regulator_request

matter_refstringRequired
production_prefixstringRequired
purposestringRequired
received_atstring · date-timeRequired
requester_typestringRequired

Private_party, court, government_authority or bank_regulator

response_due_atstring · date-time or nullOptional
rfpaobject or nullOptional

RFPADetermination records the bank's determination for a government authority's request: the written certificate of compliance 12 U.S.C. 3403(b) requires before customer financial records are released, or the evidenced determination that the certificate does not apply.

4 child attributes
determinationstringRequired

Certificate_received or not_applicable

evidence_refstringRequired
evidence_sha256stringRequired
reasonstringRequired
scopeobjectRequired

LegalScope selects what a production collects. Every named dimension must match; within a dimension any listed value matches. Families name registered sources, RetainedRecords or ExternalDocuments; no families means every archive family, which the request must acknowledge with BankWide and its reason, because that places a bank-wide hold: every registered connector starts retaining superseded rows in its own database until the hold is released.

8 child attributes
account_idsarray of stringsRequired
bank_widebooleanOptional
bank_wide_reasonstringOptional
custodiansarray of stringsRequired
customer_idsarray of stringsRequired
familiesarray of objectsRequired
2 child attributes
servicestringRequired
sourcestringRequired
fromstring · date-time or nullOptional
throughstring · date-time or nullOptional

Errors

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

400401403404409412413422424429500503

to move to open esc to close