Bind an approved correction determination to the production packet correcting the predecessor's exact BSA identifier
/bsa-filings/corrections/{packet_id}/{sequence}/linksConfidential corrected and amended report obligations on an accepted production CTR or SAR activity, keyed by the predecessor packet and activity sequence, with dedicated compliance:filings staff authority and recent step-up for controls and export. A production acknowledgment carrying warnings, a packet-level correction or explicit staff action records a candidate; none asserts an error or a clock. Test acceptances, rejections and unacknowledged packets are refused. A different reviewer approves each evidenced determination. Only primary_error_notification has a due date: 30 calendar days after the acknowledgment day, as FinCEN's CTR 1.8 and SAR 1.6 XML guides (Attachment B) recommend; errors_discovered and additional_data_discovered are tracked with due_date_rule no_fincen_due_date. The software does not classify FinCEN error codes. A link needs a production packet naming the predecessor and its exact BSA identifier.
Path parameters
packet_idstringRequiredsequencestringRequiredHeaders
Idempotency-KeystringOptionalSend 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_sha256stringRequiredpacket_idstringRequiredversionintegerRequiredReturns
200 OK
activity_sequenceintegerRequiredbsa_idstringOptionalcorrection_packetsarray of objectsRequired4 child attributes
content_sha256stringRequiredenvironmentstringRequiredpacket_idstringRequiredstatusstringRequiredcreated_atstring · date-timeRequiredcurrent_versionintegerRequiredcursorstringRequireddue_datestring · dateRequiredA business date, YYYY-MM-DD
due_date_rulestringOptionalfiling_datestring · dateRequiredA business date, YYYY-MM-DD
filing_timingstringRequiredformstringRequiredlinked_packet_idstringOptionallinksarray of objectsRequired7 child attributes
acknowledgment_sha256stringOptionalactorstringRequiredatstring · date-timeRequiredcontent_sha256stringRequiredpacket_content_sha256stringRequiredpacket_idstringRequiredversionintegerRequiredoverduebooleanRequiredpacket_idstringRequiredpredecessorobjectRequiredCorrectionPredecessor is the accepted production activity as its authenticated evidence establishes it: the retained packet and batch, a digest of the assigned BSA identifier, the transmission (filing) day, the day the acknowledgment carrying any error notification was received, and that activity's retained warning numbers.
7 child attributes
batch_sha256stringRequiredbsa_id_sha256stringRequiredcontent_sha256stringRequiredfiling_datestring · dateRequiredA business date, YYYY-MM-DD
formstringRequirednotification_datestring · dateRequiredA business date, YYYY-MM-DD
warning_sequencesarray of integersOptionalstagestringRequiredversionsarray of objectsRequired14 child attributes
activity_sequenceintegerRequiredbase_versionintegerRequiredbasis_sha256stringRequiredcontent_sha256stringRequireddeterminationobjectRequiredCorrectionDetermination is the reviewed conclusion. Grounds: - primary_error_notification: required corrected report; names the retained warnings the reviewer classified as primary errors; trigger is the day the acknowledgment was received; due 30 calendar days later as FinCEN recommends. - errors_discovered: required corrected report; trigger is the reviewed day the errors were discovered; no FinCEN due date. - additional_data_discovered: required amended report; trigger is the reviewed day the data was discovered; no FinCEN due date. - warnings_not_primary: not required; names the retained warnings reviewed as secondary only. - no_correction_needed: not required.
5 child attributes
dispositionstringRequiredRequired or not_required
groundstringRequiredreport_kindstringOptionalCorrected or amended
trigger_datestring · dateRequiredA business date, YYYY-MM-DD
warning_sequencesarray of integersOptionaldue_datestring · dateRequiredA business date, YYYY-MM-DD
due_date_rulestringRequiredpacket_idstringRequiredpredecessorobjectRequiredCorrectionPredecessor is the accepted production activity as its authenticated evidence establishes it: the retained packet and batch, a digest of the assigned BSA identifier, the transmission (filing) day, the day the acknowledgment carrying any error notification was received, and that activity's retained warning numbers.
7 child attributes
batch_sha256stringRequiredbsa_id_sha256stringRequiredcontent_sha256stringRequiredfiling_datestring · dateRequiredA business date, YYYY-MM-DD
formstringRequirednotification_datestring · dateRequiredA business date, YYYY-MM-DD
warning_sequencesarray of integersOptionalproposed_atstring · date-timeRequiredproposed_bystringRequiredreviewobject or nullOptional4 child attributes
actorstringRequiredapprovebooleanRequiredatstring · date-timeRequiredcontent_sha256stringRequiredrules_idstringRequiredversionintegerRequiredwarningsarray of objectsRequired6 child attributes
codestringOptionalcontextstringOptionalelementstringOptionallevelstringOptionalsequenceintegerRequiredtextstringOptionalErrors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503