Read every filing packet's confidential five-year retention schedule, holds and disposition state
/bsa-filings/retentionConfidential five-year retention of filed reports and supporting documentation (31 CFR 1020.320(d), 1010.306(a)(2), 1010.430(d)), with dedicated compliance:filings staff authority and recent step-up for controls. Only an accepted production filing has a schedule, starting on the later of its authenticated transmission day and the batch's filing date; other packets are retained without disposition. A legal hold on named packets or every filing record applies immediately and ends only when a reviewer who neither placed it nor proposed the release approves. Disposition is refused under any active hold or on or before the last retained day; a different reviewer's approval destroys only the encrypted documents in one transaction and retains a receipt for each, leaving packet metadata, decisions, signed receipts and access history. These records are excluded from general audit export and the bank-records archive.
Returns
200 OK
dataarray of objectsRequired10 child attributes
active_holdsarray of integersRequiredas_ofstring · dateRequiredA business date, YYYY-MM-DD
content_sha256stringRequireddispositionsarray of objectsRequired12 child attributes
basisstringRequiredcontent_sha256stringRequiredevidence_referencestringRequiredevidence_sha256stringRequiredpacket_content_sha256stringRequiredpacket_idstringRequiredproposed_atstring · date-timeRequiredproposed_bystringRequiredretain_throughstring · dateRequiredA business date, YYYY-MM-DD
reviewobject or nullOptionalRetentionDispositionReview is the independent decision. An approval retains the verified accepted status the destroyed acknowledgment established.
5 child attributes
actorstringRequiredapprovebooleanRequiredatstring · date-timeRequiredcontent_sha256stringRequiredpacket_statusstringOptionalrules_idstringRequiredversionintegerRequiredenvironmentstringRequiredformstringRequiredpacket_idstringRequiredreceiptsarray of objectsRequired7 child attributes
content_sha256stringRequireddisposition_versionintegerRequiredenvelope_sha256stringRequiredkey_idstringRequiredkindstringRequiredpacket_idstringRequiredrecorded_atstring · date-timeRequiredscheduleobject or nullOptionalRetentionSchedule exists only for an accepted production filing: drafts, cancelled, rejected, unreleased and test packets have none and are never disposed.
8 child attributes
created_atstring · date-timeRequiredfiling_datestring · dateRequiredA business date, YYYY-MM-DD
formstringRequiredpacket_idstringRequiredreport_datestring · dateRequiredA business date, YYYY-MM-DD
retain_throughstring · dateRequiredA business date, YYYY-MM-DD
retention_startstring · dateRequiredA business date, YYYY-MM-DD
rules_idstringRequiredstagestringRequiredhas_morebooleanRequiredErrors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503