Skip to content
MidLyr Docs

The Regulation Detail Object

The regulation detail object extends the regulation object with total document size, a table of contents, and category-specific attributes. It is returned by the Read Regulation API.

The document’s body text is not part of this object. Fetch text through the Read Regulation Content API.

Object Shape

Section titled “Object Shape”
{
  "id": "01HXZ3K4M7QR9VP2N8WYJF5GTB",
  "category": "regulation",
  "title": "Suspicious Activity Report Filing Requirements for Banks",
  "authorities": ["fincen"],
  "jurisdictions": ["us-federal"],
  "description": "Part of the Bank Secrecy Act / Anti-Money Laundering (BSA/AML) framework...",
  "updatedAt": "2026-04-09T00:00:00Z",
  "sourceUrl": "https://www.ecfr.gov/current/title-31/...",
  "totalBytes": 28400,
  "tableOfContents": {
    "entries": [
      { "id": "toc_a", "title": "(a) General", "level": 1, "startOffset": 0 },
      { "id": "toc_a_1", "title": "(1) Filing obligation", "level": 2, "startOffset": 120, "parentId": "toc_a" },
      { "id": "toc_b", "title": "(b) Filing procedures", "level": 1, "startOffset": 4200 }
    ]
  },
  "attributes": {
    "category": "regulation",
    "citation": "31 CFR 1020.320",
    "sourceUrl": "https://www.ecfr.gov/current/title-31/...",
    "cfrTitle": 31,
    "cfrPart": 1020,
    "cfrSection": "1020.320",
    "effectiveDate": "2011-03-01",
    "lastAmendedDate": "2023-08-15"
  }
}

Fields

Section titled “Fields”

All fields from the regulation object are included, plus:

FieldTypeDescription
totalBytesintegerTotal byte count of the full document text
tableOfContentsobject{ entries: TOCEntry[] } — flat list of heading entries with character offsets
attributesobject or nullPer-category structured metadata. Shape depends on category. null when attributes are not available.

Table of Contents Entries

Section titled “Table of Contents Entries”

Each TOC entry describes one heading in the document:

FieldTypeDescription
idstringStable id for the TOC entry
titlestringHeading text as it appears in the document
levelintegerHeading depth (1 is top-level)
startOffsetintegerCharacter offset where this section begins in the full document text
parentIdstringOptional id of the enclosing entry, when the TOC is hierarchical

Categories and Attributes

Section titled “Categories and Attributes”

Every document has exactly one category identifying what kind of compliance source it is. “Regulations” in this API follows the compliance-officer meaning — the full body of rules a bank must follow, not the narrow CFR-section meaning.

The attributes object carries a category discriminator and category-specific fields. Every variant includes three base fields — category, citation, and sourceUrl — plus fields specific to that category. Not every attribute is populated for every document — optional fields may be absent.

statute

Section titled “statute”

Laws enacted by Congress or a state legislature (e.g., BSA, Dodd-Frank, GLBA, CCPA, state money transmitter acts).

{
  "publicLawNumber": "91-508",
  "enactedDate": "1970-10-26",
  "uscTitle": 31,
  "uscChapter": 53
}

regulation

Section titled “regulation”

Binding rules issued by an agency and published in the CFR or a state administrative code (e.g., 12 CFR 1026, 23 NYCRR 500).

{
  "cfrTitle": 31,
  "cfrPart": 1020,
  "cfrSection": "1020.320",
  "effectiveDate": "2011-03-01",
  "lastAmendedDate": "2023-08-15"
}

interagencyGuidance

Section titled “interagencyGuidance”

Joint issuances by multiple federal agencies establishing shared supervisory expectations.

{
  "issuingAuthorities": ["occ", "fdic", "fed"],
  "documentNumber": "SR 23-4",
  "issuedOn": "2023-06-06"
}

agencyGuidance

Section titled “agencyGuidance”

Bulletins, financial institution letters, advisories, and supervisory letters from a single agency.

{
  "documentNumber": "OCC Bulletin 2023-17",
  "issuedOn": "2023-06-07",
  "applicability": "national banks and federal savings associations"
}

examinationHandbook

Section titled “examinationHandbook”

Examiner playbooks defining what constitutes a satisfactory program.

{
  "handbookName": "FFIEC BSA/AML Examination Manual",
  "section": "Customer Due Diligence",
  "version": "2024"
}

interpretiveAction

Section titled “interpretiveAction”

Formal legal opinions, interpretive letters, rulings, and topical FAQs.

{
  "documentNumber": "OCC Interpretive Letter 1183",
  "issuedOn": "2023-11-14",
  "addressee": "Anonymous Bank"
}

sroRule

Section titled “sroRule”

Rules issued by self-regulatory organizations (FINRA, MSRB, NFA, NACHA).

{
  "ruleNumber": "FINRA Rule 3310",
  "effectiveDate": "2014-01-01"
}