Read a legal request and its productions with an audited purpose
/bank-records/legal-requests/{request}Path parameters
requeststringRequiredQuery parameters
purposestringOptionalReturns
200 OK
actorstringRequiredcreated_atstring · date-timeRequiredidstringRequiredproductionsarray of objectsRequired16 child attributes
actorstringRequiredapproved_bystringOptionalcreated_atstring · date-timeRequiredhigh_waterintegerOptionalholdsarray of objectsRequired5 child attributes
bank_widebooleanOptionalcustomer_idstringOptionalExample cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm
hold_idstringRequiredExample hold_2tVh8nqLxq4GbDe0K1F6S9zRcWm
kindstringRequiredBank_archive or customer_archive
targetobjectRequired2 child attributes
servicestringRequiredsourcestringRequiredidstringRequireditemsintegerRequiredlegal_request_idstringRequiredExample req_2tVh8nqLxq4GbDe0K1F6S9zRcWm
packageobject or nullOptional7 child attributes
first_numberstringOptionallast_numberstringOptionalmanifest_sha256stringRequiredpackage_sha256stringRequiredpackaged_atstring · date-timeRequiredpackaged_bystringRequiredpartsintegerRequiredreleased_atstring · date-time or nullOptionalrequired_determinationsarray of stringsRequiredreview_requiredintegerRequiredroot_sha256stringOptionalscopeobjectRequiredLegalScope 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 stringsRequiredbank_widebooleanOptionalbank_wide_reasonstringOptionalcustodiansarray of stringsRequiredcustomer_idsarray of stringsRequiredfamiliesarray of objectsRequired2 child attributes
servicestringRequiredsourcestringRequiredfromstring · date-time or nullOptionalthroughstring · date-time or nullOptionalsequenceintegerRequiredstatusstringRequiredrequestobjectRequired12 child attributes
basisobjectRequiredLegalBasis 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
citationstringRequiredevidence_refstringRequiredevidence_sha256stringRequiredreasonstringRequiredcounselstringRequiredissuing_authoritystringRequiredkindstringRequiredSubpoena, court_order or regulator_request
matter_refstringRequiredproduction_prefixstringRequiredpurposestringRequiredreceived_atstring · date-timeRequiredrequester_typestringRequiredPrivate_party, court, government_authority or bank_regulator
response_due_atstring · date-time or nullOptionalrfpaobject or nullOptionalRFPADetermination 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
determinationstringRequiredCertificate_received or not_applicable
evidence_refstringRequiredevidence_sha256stringRequiredreasonstringRequiredscopeobjectRequiredLegalScope 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 stringsRequiredbank_widebooleanOptionalbank_wide_reasonstringOptionalcustodiansarray of stringsRequiredcustomer_idsarray of stringsRequiredfamiliesarray of objectsRequired2 child attributes
servicestringRequiredsourcestringRequiredfromstring · date-time or nullOptionalthroughstring · date-time or nullOptionalErrors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503