@invinite-org/invinite-data-cli 0.13.1 → 1.1.0

package/dist/src/generated/cli-manifest.json

@@ -1,6 +1,6 @@
 {
   "specVersion": "1.0.0",
-  "specSha256": "99044f5390ccb96f40ef3fd1b1b19cab54c7de89ec1000af86ed8b999ab57912",
+  "specSha256": "eeed886bbc63024fdde1a5a34fd91d022bc31359e93f2dc0ed2ce628bd252a48",
   "groups": [
     {
       "name": "company",
@@ -10,10 +10,6 @@
       "name": "earnings",
       "description": "Earnings calls: calendar, transcripts, Q&A, extractions, media, search and webhook subscriptions"
     },
-    {
-      "name": "filings",
-      "description": "SEC filings, their parsed sections and natural-language filing search"
-    },
     {
       "name": "financials",
       "description": "Financial statements (standardized & as-reported)"
@@ -50,6 +46,10 @@
       "name": "ownership",
       "description": "13F holdings, holders and position changes of institutional investors"
     },
+    {
+      "name": "sec",
+      "description": "Invinite's SEC document store: filers and issuer lifecycle, filings with their documents, immutable cited document versions (blocks, pages, figures, sections, XBRL fact places), lexical / literal search, 13F holdings research, standardized-statement provenance and metric exports"
+    },
     {
       "name": "segments",
       "description": "Financial facts broken down by business and geographic segment"
@@ -570,6 +570,37 @@
           "default": 0,
           "example": 0,
           "description": "Number of events to skip for pagination"
+        },
+        {
+          "name": "date_kind",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "call",
+            "report"
+          ],
+          "example": "call",
+          "description": "Which day `from` / `to` select: `call` (the default: the call day, as described above) or `report` (the results release day, `calendar.report.date`; ordered by it)"
+        },
+        {
+          "name": "calendar_status",
+          "in": "query",
+          "required": false,
+          "type": "array",
+          "items": "string",
+          "enum": [
+            "cancelled",
+            "postponed",
+            "reported",
+            "confirmed",
+            "announced",
+            "estimated"
+          ],
+          "example": [
+            "confirmed"
+          ],
+          "description": "Filter by `calendar.status` (repeatable), applied beside `status`"
         }
       ],
       "view": "table",
@@ -2146,218 +2177,6 @@
       ],
       "pagination": "none"
     },
-    {
-      "operationId": "secFilingsAvailableFormTypes",
-      "group": "filings",
-      "action": "form-types",
-      "method": "get",
-      "path": "/v1/sec-filings/available-form-types",
-      "auth": true,
-      "summary": "Available SEC form types",
-      "params": [
-        {
-          "name": "identifier",
-          "in": "query",
-          "required": false,
-          "type": "string",
-          "example": "AAPL",
-          "description": "Optional ticker symbol or CIK. If omitted, returns form types across all filings.",
-          "alias": "i"
-        }
-      ],
-      "view": "json",
-      "pagination": "none"
-    },
-    {
-      "operationId": "secFilingsList",
-      "group": "filings",
-      "action": "list",
-      "method": "get",
-      "path": "/v1/sec-filings/filings",
-      "auth": true,
-      "summary": "SEC filings",
-      "params": [
-        {
-          "name": "identifier",
-          "in": "query",
-          "required": true,
-          "type": "string",
-          "example": "AAPL",
-          "description": "Ticker symbol or CIK. A CIK also finds a registrant that is not listed yet (pre-IPO).",
-          "alias": "i"
-        },
-        {
-          "name": "form_type",
-          "in": "query",
-          "required": false,
-          "type": "string",
-          "example": "10-K",
-          "description": "SEC form type filter (e.g., 10-K, 10-Q, 8-K, 3, 4, 5, 13F-HR). Leave empty to return all form types."
-        },
-        {
-          "name": "sort",
-          "in": "query",
-          "required": false,
-          "type": "string",
-          "enum": [
-            "asc",
-            "desc"
-          ],
-          "default": "desc",
-          "example": "desc",
-          "description": "Sort direction for filings by filing_date",
-          "alias": "s"
-        },
-        {
-          "name": "limit",
-          "in": "query",
-          "required": false,
-          "type": "integer",
-          "default": 40,
-          "example": 5,
-          "description": "Maximum number of filings to return",
-          "alias": "l"
-        },
-        {
-          "name": "offset",
-          "in": "query",
-          "required": false,
-          "type": "integer",
-          "default": 0,
-          "example": 0,
-          "description": "Number of filings to skip for pagination"
-        }
-      ],
-      "view": "table",
-      "rowsPath": "companies.0.filings",
-      "columns": [
-        "filing_date",
-        "form_type",
-        "fiscal_year",
-        "fiscal_quarter",
-        "calendar_year",
-        "calendar_quarter",
-        "period_end",
-        "accession_number",
-        "html_url"
-      ],
-      "pagination": "perCompany",
-      "allItemsPath": [
-        "filings"
-      ]
-    },
-    {
-      "operationId": "secFilingsSearch",
-      "group": "filings",
-      "action": "search",
-      "method": "get",
-      "path": "/v1/sec-filings/search",
-      "auth": true,
-      "summary": "Search SEC filings",
-      "params": [
-        {
-          "name": "request",
-          "in": "query",
-          "required": true,
-          "type": "string",
-          "example": "What are Apple's main risk factors?",
-          "description": "Natural language search request for SEC filing information (e.g., 'What are Apple's main risk factors?')",
-          "alias": "r"
-        },
-        {
-          "name": "identifier",
-          "in": "query",
-          "required": false,
-          "type": "string",
-          "example": "AAPL",
-          "description": "Ticker symbol or CIK to filter search results to a specific company",
-          "alias": "i"
-        },
-        {
-          "name": "accession_number",
-          "in": "query",
-          "required": false,
-          "type": "string",
-          "example": "0000320193-25-000079",
-          "description": "Accession number to filter search results to a specific filing"
-        }
-      ],
-      "exampleParams": [
-        "identifier"
-      ],
-      "view": "json",
-      "pagination": "none"
-    },
-    {
-      "operationId": "secFilingsSections",
-      "group": "filings",
-      "action": "sections",
-      "method": "get",
-      "path": "/v1/sec-filings/sections",
-      "auth": true,
-      "summary": "SEC filing sections",
-      "params": [
-        {
-          "name": "identifier",
-          "in": "query",
-          "required": true,
-          "type": "string",
-          "example": "AAPL",
-          "description": "Ticker symbol or CIK. Financial data covers SEC registrants and US listings; a foreign suffix (`SAP.DE`, `VOD.L`) or a crypto pair (`X:BTCUSD`) is not a known company and answers 404.",
-          "alias": "i"
-        },
-        {
-          "name": "form_type",
-          "in": "query",
-          "required": true,
-          "type": "string",
-          "enum": [
-            "10-Q",
-            "10-K",
-            "8-K"
-          ],
-          "example": "10-K",
-          "description": "SEC form type. Filter requirements vary: 8-K requires accession_number; 10-K requires accession_number or fiscal_year; 10-Q requires accession_number or fiscal_year+fiscal_quarter."
-        },
-        {
-          "name": "section_id",
-          "in": "query",
-          "required": false,
-          "type": "string",
-          "example": "part_i-item_1a",
-          "description": "Optional section ID. If not specified, all sections from the filing are returned. A section the filing does not have answers 404 with the section IDs it has."
-        },
-        {
-          "name": "accession_number",
-          "in": "query",
-          "required": false,
-          "type": "string",
-          "example": "0000320193-25-000079",
-          "description": "SEC accession number of the filing"
-        },
-        {
-          "name": "fiscal_year",
-          "in": "query",
-          "required": false,
-          "type": "integer",
-          "example": 2025,
-          "description": "Fiscal year"
-        },
-        {
-          "name": "fiscal_quarter",
-          "in": "query",
-          "required": false,
-          "type": "integer",
-          "example": 4,
-          "description": "Fiscal quarter (1-4). Required for 10-Q when using fiscal_year filter."
-        }
-      ],
-      "exampleParams": [
-        "fiscal_year"
-      ],
-      "view": "json",
-      "pagination": "none"
-    },
     {
       "operationId": "asReportedBalanceSheet",
       "group": "financials",
@@ -4354,6 +4173,18 @@
           "example": "false",
           "description": "true = blank-check companies (SPACs) only, false = no SPACs. Default: both"
         },
+        {
+          "name": "pending",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "true",
+          "description": "true = tracks with an open IPO-pending entry (`ipo_pending.status` open), false = tracks without one. Default: both"
+        },
         {
           "name": "sort",
           "in": "query",
@@ -5669,6 +5500,1643 @@
         "transactions"
       ]
     },
+    {
+      "operationId": "secDatasets",
+      "group": "sec",
+      "action": "datasets",
+      "method": "get",
+      "path": "/v1/sec/datasets",
+      "auth": true,
+      "summary": "SEC dataset releases",
+      "params": [],
+      "view": "json",
+      "pagination": "none"
+    },
+    {
+      "operationId": "secDocument",
+      "group": "sec",
+      "action": "document",
+      "method": "get",
+      "path": "/v1/sec/documents/{accession}/{filename}",
+      "auth": true,
+      "summary": "SEC document (current version)",
+      "params": [
+        {
+          "name": "blocks",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "b00107-b00244",
+          "description": "A block id or range (`b00107` or `b00107-b00244`; a section's `blocks` selector)",
+          "alias": "b"
+        },
+        {
+          "name": "pages",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "1-3",
+          "description": "Physical page ordinals (`3` or `3-5`)",
+          "alias": "p"
+        },
+        {
+          "name": "printed",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "17",
+          "description": "An exact printed page label (`F-7`, `iv`, `12`): compared as the string printed, never as a number"
+        },
+        {
+          "name": "printed_occurrence",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "example": 1,
+          "description": "Which page carrying a repeated printed label (1-based, page order)"
+        },
+        {
+          "name": "neighbors",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "example": 1,
+          "description": "Widen the selection by this many blocks on each side (same version)"
+        },
+        {
+          "name": "footnotes",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "true",
+          "description": "Add the footnote blocks the selection links to (same version) (`true` or `false`)"
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "example": 5,
+          "description": "At most this many blocks (1-1000); the answer names the next block when cut",
+          "alias": "l"
+        },
+        {
+          "name": "accession",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "0000320193-26-000026",
+          "description": "Accession number, dashed (0000320193-26-000026) or 18 digits"
+        },
+        {
+          "name": "filename",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "aapl-20260926.htm",
+          "description": "The document's file name in the filing (a manifest's `filename`)"
+        }
+      ],
+      "view": "json",
+      "pagination": "none"
+    },
+    {
+      "operationId": "secExport",
+      "group": "sec",
+      "action": "export",
+      "method": "get",
+      "path": "/v1/sec/exports/{export_id}",
+      "auth": true,
+      "summary": "Metric export manifest",
+      "params": [
+        {
+          "name": "export_id",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "6a7350b9-df18-517b-b553-96601b1e0508",
+          "description": "Export id"
+        }
+      ],
+      "view": "json",
+      "pagination": "none"
+    },
+    {
+      "operationId": "secDocumentFactPlaces",
+      "group": "sec",
+      "action": "fact-places",
+      "method": "get",
+      "path": "/v1/sec/versions/{version_id}/fact-places",
+      "auth": true,
+      "summary": "XBRL fact places in a document version",
+      "params": [
+        {
+          "name": "fact_id",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "320193|is_total_revenue|annual|2026|4",
+          "description": "One fact id"
+        },
+        {
+          "name": "status",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "exact",
+            "ambiguous",
+            "hidden",
+            "not_in_document",
+            "derived",
+            "unmatched"
+          ],
+          "example": "exact",
+          "description": "Places of this status only"
+        },
+        {
+          "name": "cursor",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "MTIz",
+          "description": "Opaque cursor of the previous page (`next_cursor`; follow `next_url`). Bound to the other filters."
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 100,
+          "example": 5,
+          "description": "Places per page (1-500, default 100)"
+        },
+        {
+          "name": "version_id",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "8be0b759-1a9d-5f89-8308-bd86185f5e1f",
+          "description": "An immutable document version (`version.version_id` of a document read, a search hit's citation)"
+        }
+      ],
+      "view": "json",
+      "pagination": "top",
+      "allItemsPath": [
+        "places"
+      ]
+    },
+    {
+      "operationId": "secDocumentFigure",
+      "group": "sec",
+      "action": "figure",
+      "method": "get",
+      "path": "/v1/sec/versions/{version_id}/figures/{block_id}",
+      "auth": true,
+      "summary": "SEC document figure",
+      "params": [
+        {
+          "name": "version_id",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "8be0b759-1a9d-5f89-8308-bd86185f5e1f",
+          "description": "An immutable document version (`version.version_id` of a document read, a search hit's citation)"
+        },
+        {
+          "name": "block_id",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "b00107",
+          "description": "The figure's block id (`b00042`)"
+        }
+      ],
+      "view": "json",
+      "pagination": "none"
+    },
+    {
+      "operationId": "secFiler",
+      "group": "sec",
+      "action": "filer",
+      "method": "get",
+      "path": "/v1/sec/filers/{cik}",
+      "auth": true,
+      "summary": "SEC filer",
+      "params": [
+        {
+          "name": "cik",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "320193",
+          "description": "SEC CIK of the filer (any zero padding)"
+        }
+      ],
+      "view": "json",
+      "pagination": "none"
+    },
+    {
+      "operationId": "secFilerCoverage",
+      "group": "sec",
+      "action": "filer-coverage",
+      "method": "get",
+      "path": "/v1/sec/filers/{cik}/coverage",
+      "auth": true,
+      "summary": "SEC filer document coverage",
+      "params": [
+        {
+          "name": "since",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2025-11-01",
+          "description": "First filing day of the window (YYYY-MM-DD, at most 3 years back)",
+          "alias": "s"
+        },
+        {
+          "name": "cik",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "320193",
+          "description": "SEC CIK of the filer (any zero padding)"
+        }
+      ],
+      "view": "json",
+      "pagination": "none"
+    },
+    {
+      "operationId": "secFilers",
+      "group": "sec",
+      "action": "filers",
+      "method": "get",
+      "path": "/v1/sec/filers",
+      "auth": true,
+      "summary": "Find SEC filers",
+      "params": [
+        {
+          "name": "name",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "Apple",
+          "description": "Name or former name (substring)",
+          "alias": "n"
+        },
+        {
+          "name": "ticker",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "AAPL",
+          "description": "A ticker the filer stated to the SEC",
+          "alias": "t"
+        },
+        {
+          "name": "form",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "13F-HR",
+          "description": "A form type the filer filed (exact, e.g. 13F-HR)",
+          "alias": "f"
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 20,
+          "example": 5,
+          "description": "Matches (1-50, default 20)",
+          "alias": "l"
+        }
+      ],
+      "view": "table",
+      "rowsPath": "matches",
+      "columns": [
+        "cik",
+        "name",
+        "entity_type",
+        "sic"
+      ],
+      "pagination": "none"
+    },
+    {
+      "operationId": "secFiling",
+      "group": "sec",
+      "action": "filing",
+      "method": "get",
+      "path": "/v1/sec/filings/{accession}",
+      "auth": true,
+      "summary": "SEC filing and its documents",
+      "params": [
+        {
+          "name": "accession",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "0000320193-26-000026",
+          "description": "Accession number, dashed (0000320193-26-000026) or 18 digits",
+          "alias": "a"
+        }
+      ],
+      "view": "json",
+      "pagination": "none"
+    },
+    {
+      "operationId": "secFilingFacts",
+      "group": "sec",
+      "action": "filing-facts",
+      "method": "get",
+      "path": "/v1/sec/filings/{accession}/facts",
+      "auth": true,
+      "summary": "SEC dataset facts of a filing",
+      "params": [
+        {
+          "name": "tag",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "Revenues",
+          "description": "One XBRL tag (e.g. Revenues)",
+          "alias": "t"
+        },
+        {
+          "name": "accession",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "0000320193-26-000026",
+          "description": "Accession number, dashed (0000320193-26-000026) or 18 digits"
+        }
+      ],
+      "view": "json",
+      "pagination": "none"
+    },
+    {
+      "operationId": "secFilingHoldings",
+      "group": "sec",
+      "action": "filing-holdings",
+      "method": "get",
+      "path": "/v1/sec/filings/{accession}/holdings",
+      "auth": true,
+      "summary": "Holdings of a 13F filing",
+      "params": [
+        {
+          "name": "after",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "example": 0,
+          "description": "Row key of the previous page (`next_after`; follow `next_url`)"
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 500,
+          "example": 5,
+          "description": "Positions per page (1-1000, default 500)",
+          "alias": "l"
+        },
+        {
+          "name": "accession",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "0000320193-26-000026",
+          "description": "Accession number, dashed (0000320193-26-000026) or 18 digits"
+        }
+      ],
+      "view": "json",
+      "pagination": "top",
+      "allItemsPath": [
+        "rows"
+      ]
+    },
+    {
+      "operationId": "secFilingNotes",
+      "group": "sec",
+      "action": "filing-notes",
+      "method": "get",
+      "path": "/v1/sec/filings/{accession}/notes",
+      "auth": true,
+      "summary": "SEC dataset text notes of a filing",
+      "params": [
+        {
+          "name": "tag",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "Revenues",
+          "description": "One XBRL tag",
+          "alias": "t"
+        },
+        {
+          "name": "accession",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "0000320193-26-000026",
+          "description": "Accession number, dashed (0000320193-26-000026) or 18 digits"
+        }
+      ],
+      "view": "json",
+      "pagination": "none"
+    },
+    {
+      "operationId": "secFilings",
+      "group": "sec",
+      "action": "filings",
+      "method": "get",
+      "path": "/v1/sec/filings",
+      "auth": true,
+      "summary": "SEC filings of a filer",
+      "params": [
+        {
+          "name": "identifier",
+          "in": "query",
+          "required": true,
+          "type": "string",
+          "example": "AAPL",
+          "description": "A ticker the filer stated to the SEC, or a CIK (a CIK also finds a pre-IPO issuer)",
+          "alias": "i"
+        },
+        {
+          "name": "form",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "10-K,10-K/A",
+          "description": "Form types, a comma list (e.g. `10-K,10-K/A`)",
+          "alias": "f"
+        },
+        {
+          "name": "filed_from",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2025-01-01",
+          "description": "First filing day (YYYY-MM-DD)"
+        },
+        {
+          "name": "filed_to",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-11-05",
+          "description": "Last filing day (YYYY-MM-DD)"
+        },
+        {
+          "name": "order",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "desc",
+            "asc"
+          ],
+          "example": "desc",
+          "description": "By filing date (default desc)"
+        },
+        {
+          "name": "cursor",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "eyJ2IjoxLCJhZnRlciI6WyIyMDI1LTEwLTMxIiwiMDAwMDMyMDE5My0yNS0wMDAwNzkiXSwiZiI6Ijg1NzNiMDg0ZjEyNzVjMjMifQ",
+          "description": "Opaque cursor of the previous page (`next_cursor`; follow `next_url`). Bound to the other filters."
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 50,
+          "example": 5,
+          "description": "Filings per page (1-100, default 50)",
+          "alias": "l"
+        }
+      ],
+      "view": "table",
+      "rowsPath": "filings",
+      "columns": [
+        "filing_date",
+        "form",
+        "accession",
+        "report_date",
+        "primary_document"
+      ],
+      "pagination": "top",
+      "allItemsPath": [
+        "filings"
+      ]
+    },
+    {
+      "operationId": "secFinancialsFact",
+      "group": "sec",
+      "action": "financial-fact",
+      "method": "get",
+      "path": "/v1/sec/financials/facts",
+      "auth": true,
+      "summary": "Explain a standardized fact",
+      "params": [
+        {
+          "name": "id",
+          "in": "query",
+          "required": true,
+          "type": "string",
+          "example": "320193|is_total_revenue|annual|2026|4",
+          "description": "Fact id `cik|metric_id|period type|fiscal year|fiscal quarter` (the `id` of a standardized row)"
+        },
+        {
+          "name": "max_depth",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "example": 3,
+          "description": "Formula depth (1-6, default 4)"
+        },
+        {
+          "name": "max_members",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "example": 64,
+          "description": "Formula members at most (1-200, default 64)"
+        },
+        {
+          "name": "places",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "true",
+          "description": "Resolve the source facts' places (default true) (`true` or `false`)"
+        }
+      ],
+      "view": "json",
+      "pagination": "none"
+    },
+    {
+      "operationId": "secFinancialsCatalog",
+      "group": "sec",
+      "action": "financials-catalog",
+      "method": "get",
+      "path": "/v1/sec/financials/catalog",
+      "auth": true,
+      "summary": "Standardization rule catalog",
+      "params": [
+        {
+          "name": "statement",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "income_statement",
+            "balance_sheet",
+            "cash_flow_statement"
+          ],
+          "example": "income_statement",
+          "description": "One statement",
+          "alias": "s"
+        },
+        {
+          "name": "metric_id",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "is_total_revenue",
+          "description": "One standardized metric"
+        }
+      ],
+      "view": "json",
+      "pagination": "none"
+    },
+    {
+      "operationId": "secHoldingsFormFilers",
+      "group": "sec",
+      "action": "form-filers",
+      "method": "get",
+      "path": "/v1/sec/holdings/form-filers",
+      "auth": true,
+      "summary": "Filers of an SEC form",
+      "params": [
+        {
+          "name": "form",
+          "in": "query",
+          "required": true,
+          "type": "string",
+          "example": "13F-HR",
+          "description": "The form type (e.g. 13F-HR)",
+          "alias": "f"
+        },
+        {
+          "name": "exact",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "false",
+          "description": "Only this exact form (not its amendments) (`true` or `false`)"
+        },
+        {
+          "name": "name",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "Berkshire",
+          "description": "Filer name (substring)",
+          "alias": "n"
+        },
+        {
+          "name": "cik",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "1067983",
+          "description": "One filer CIK"
+        },
+        {
+          "name": "cursor",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "eyJ2IjoxLCJhZnRlciI6WyIyMDI1LTEwLTMxIiwiMDAwMDMyMDE5My0yNS0wMDAwNzkiXSwiZiI6Ijg1NzNiMDg0ZjEyNzVjMjMifQ",
+          "description": "Opaque cursor of the previous page (`next_cursor`; follow `next_url`). Bound to the other filters."
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 50,
+          "example": 5,
+          "description": "Rows per page (1-200, default 50)",
+          "alias": "l"
+        }
+      ],
+      "view": "json",
+      "pagination": "top",
+      "allItemsPath": [
+        "rows"
+      ]
+    },
+    {
+      "operationId": "secHoldingsHolders",
+      "group": "sec",
+      "action": "holders",
+      "method": "get",
+      "path": "/v1/sec/holdings/holders",
+      "auth": true,
+      "summary": "Institutional holders of a security (13F)",
+      "params": [
+        {
+          "name": "period_end",
+          "in": "query",
+          "required": true,
+          "type": "string",
+          "example": "2026-06-30",
+          "description": "The 13F report quarter end (YYYY-MM-DD)"
+        },
+        {
+          "name": "cusip",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "037833100",
+          "description": "Security CUSIP"
+        },
+        {
+          "name": "symbol",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "AAPL",
+          "description": "Ticker symbol",
+          "alias": "s"
+        },
+        {
+          "name": "issuer_cik",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "320193",
+          "description": "Issuer CIK"
+        },
+        {
+          "name": "instruments",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "shareholder",
+            "all"
+          ],
+          "example": "shareholder",
+          "description": "`shareholder` (common / ordinary shares) or `all` (also options, notes, …; default shareholder)"
+        },
+        {
+          "name": "pinned_at",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-11-05T00:00:00Z",
+          "description": "Read every row as of this instant (`pinned_at` of a previous page keeps pages consistent)"
+        },
+        {
+          "name": "cursor",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "eyJ2IjoxLCJhZnRlciI6WyIyMDI1LTEwLTMxIiwiMDAwMDMyMDE5My0yNS0wMDAwNzkiXSwiZiI6Ijg1NzNiMDg0ZjEyNzVjMjMifQ",
+          "description": "Opaque cursor of the previous page (`next_cursor`; follow `next_url`). Bound to the other filters."
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 50,
+          "example": 5,
+          "description": "Rows per page (1-200, default 50)",
+          "alias": "l"
+        }
+      ],
+      "view": "json",
+      "pagination": "top",
+      "allItemsPath": [
+        "rows"
+      ]
+    },
+    {
+      "operationId": "secHoldingsDeltas",
+      "group": "sec",
+      "action": "holding-deltas",
+      "method": "get",
+      "path": "/v1/sec/holdings/deltas",
+      "auth": true,
+      "summary": "Position changes in a security (13F)",
+      "params": [
+        {
+          "name": "period_end",
+          "in": "query",
+          "required": true,
+          "type": "string",
+          "example": "2026-06-30",
+          "description": "The 13F report quarter end (YYYY-MM-DD)"
+        },
+        {
+          "name": "prior_period_end",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-03-31",
+          "description": "The quarter compared with (default the previous quarter)"
+        },
+        {
+          "name": "cusip",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "037833100",
+          "description": "Security CUSIP"
+        },
+        {
+          "name": "symbol",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "AAPL",
+          "description": "Ticker symbol",
+          "alias": "s"
+        },
+        {
+          "name": "issuer_cik",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "320193",
+          "description": "Issuer CIK"
+        },
+        {
+          "name": "instruments",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "shareholder",
+            "all"
+          ],
+          "example": "shareholder",
+          "description": "`shareholder` (common / ordinary shares) or `all` (also options, notes, …; default shareholder)"
+        },
+        {
+          "name": "pinned_at",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-11-05T00:00:00Z",
+          "description": "Read every row as of this instant (`pinned_at` of a previous page keeps pages consistent)"
+        },
+        {
+          "name": "cursor",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "eyJ2IjoxLCJhZnRlciI6WyIyMDI1LTEwLTMxIiwiMDAwMDMyMDE5My0yNS0wMDAwNzkiXSwiZiI6Ijg1NzNiMDg0ZjEyNzVjMjMifQ",
+          "description": "Opaque cursor of the previous page (`next_cursor`; follow `next_url`). Bound to the other filters."
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 50,
+          "example": 5,
+          "description": "Rows per page (1-200, default 50)",
+          "alias": "l"
+        }
+      ],
+      "view": "json",
+      "pagination": "top",
+      "allItemsPath": [
+        "rows"
+      ]
+    },
+    {
+      "operationId": "secIssuers",
+      "group": "sec",
+      "action": "issuers",
+      "method": "get",
+      "path": "/v1/sec/issuers",
+      "auth": true,
+      "summary": "List SEC issuers",
+      "params": [
+        {
+          "name": "query",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "Iambic",
+          "description": "Name (substring)",
+          "alias": "q"
+        },
+        {
+          "name": "phase",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "observed",
+            "public_preipo",
+            "listed_spac",
+            "listed_operating",
+            "former_listed",
+            "unresolved"
+          ],
+          "example": "public_preipo",
+          "description": "Lifecycle phase",
+          "alias": "p"
+        },
+        {
+          "name": "form",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "S-1",
+          "description": "A form type the issuer filed"
+        },
+        {
+          "name": "public_seen_from",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-01-01",
+          "description": "First public sighting on or after (YYYY-MM-DD)"
+        },
+        {
+          "name": "public_seen_to",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-10-31",
+          "description": "First public sighting on or before (YYYY-MM-DD)"
+        },
+        {
+          "name": "cursor",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "eyJ2IjoxLCJhZnRlciI6WyIyMDI1LTEwLTMxIiwiMDAwMDMyMDE5My0yNS0wMDAwNzkiXSwiZiI6Ijg1NzNiMDg0ZjEyNzVjMjMifQ",
+          "description": "Opaque cursor of the previous page (`next_cursor`; follow `next_url`). Bound to the other filters."
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 20,
+          "example": 5,
+          "description": "Issuers per page (1-100, default 20)",
+          "alias": "l"
+        }
+      ],
+      "view": "json",
+      "pagination": "top",
+      "allItemsPath": [
+        "issuers"
+      ]
+    },
+    {
+      "operationId": "secFilerLifecycle",
+      "group": "sec",
+      "action": "lifecycle",
+      "method": "get",
+      "path": "/v1/sec/filers/{cik}/lifecycle",
+      "auth": true,
+      "summary": "SEC issuer lifecycle",
+      "params": [
+        {
+          "name": "traverse",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "successors",
+            "predecessors"
+          ],
+          "example": "successors",
+          "description": "Follow verified legal successions in this direction",
+          "alias": "t"
+        },
+        {
+          "name": "max_hops",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "example": 3,
+          "description": "At most this many successions (1-5, default 3)"
+        },
+        {
+          "name": "cik",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "320193",
+          "description": "SEC CIK of the issuer (any zero padding)"
+        }
+      ],
+      "view": "json",
+      "pagination": "none"
+    },
+    {
+      "operationId": "secExportsFinancialMetrics",
+      "group": "sec",
+      "action": "metric-export",
+      "method": "get",
+      "path": "/v1/sec/exports/financial-metrics",
+      "auth": true,
+      "summary": "Request an annual metric export",
+      "params": [
+        {
+          "name": "metric_id",
+          "in": "query",
+          "required": true,
+          "type": "string",
+          "example": "is_total_revenue",
+          "description": "Standardized metric",
+          "alias": "m"
+        },
+        {
+          "name": "fiscal_year",
+          "in": "query",
+          "required": true,
+          "type": "integer",
+          "example": 2025,
+          "description": "Fiscal year",
+          "alias": "y"
+        },
+        {
+          "name": "period_type",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "quarterly",
+            "annual",
+            "ytd",
+            "ttm"
+          ],
+          "example": "annual",
+          "description": "Period type (default annual)"
+        },
+        {
+          "name": "mode",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "standardized",
+            "raw"
+          ],
+          "example": "standardized",
+          "description": "standardized (default) or raw values"
+        },
+        {
+          "name": "generation",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "g20261104T031000Z-1a2b3c4d",
+          "description": "A past export generation (point in time)"
+        }
+      ],
+      "view": "json",
+      "pagination": "none"
+    },
+    {
+      "operationId": "secHoldingsManagerPortfolio",
+      "group": "sec",
+      "action": "portfolio",
+      "method": "get",
+      "path": "/v1/sec/holdings/managers/{cik}/portfolio",
+      "auth": true,
+      "summary": "Portfolio of a 13F manager",
+      "params": [
+        {
+          "name": "period_end",
+          "in": "query",
+          "required": true,
+          "type": "string",
+          "example": "2026-06-30",
+          "description": "The 13F report quarter end (YYYY-MM-DD)"
+        },
+        {
+          "name": "instruments",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "shareholder",
+            "all"
+          ],
+          "example": "shareholder",
+          "description": "`shareholder` (common / ordinary shares) or `all` (also options, notes, …; default all)"
+        },
+        {
+          "name": "pinned_at",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-11-05T00:00:00Z",
+          "description": "Read every row as of this instant (`pinned_at` of a previous page keeps pages consistent)"
+        },
+        {
+          "name": "cursor",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "eyJ2IjoxLCJhZnRlciI6WyIyMDI1LTEwLTMxIiwiMDAwMDMyMDE5My0yNS0wMDAwNzkiXSwiZiI6Ijg1NzNiMDg0ZjEyNzVjMjMifQ",
+          "description": "Opaque cursor of the previous page (`next_cursor`; follow `next_url`). Bound to the other filters."
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 50,
+          "example": 5,
+          "description": "Rows per page (1-200, default 50)",
+          "alias": "l"
+        },
+        {
+          "name": "cik",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "1067983",
+          "description": "CIK of the 13F manager"
+        }
+      ],
+      "view": "json",
+      "pagination": "top",
+      "allItemsPath": [
+        "rows"
+      ]
+    },
+    {
+      "operationId": "secFilingReviewChain",
+      "group": "sec",
+      "action": "review-chain",
+      "method": "get",
+      "path": "/v1/sec/filings/{accession}/review-chain",
+      "auth": true,
+      "summary": "SEC review chain of a filing",
+      "params": [
+        {
+          "name": "max_depth",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "example": 3,
+          "description": "Hops from the filing (1-6, default 3)"
+        },
+        {
+          "name": "max_nodes",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "example": 25,
+          "description": "Nodes at most (1-100, default 25)"
+        },
+        {
+          "name": "accession",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "0000320193-26-000026",
+          "description": "Accession number, dashed (0000320193-26-000026) or 18 digits"
+        }
+      ],
+      "view": "json",
+      "pagination": "none"
+    },
+    {
+      "operationId": "secFilingReviewRelations",
+      "group": "sec",
+      "action": "review-relations",
+      "method": "get",
+      "path": "/v1/sec/filings/{accession}/review-relations",
+      "auth": true,
+      "summary": "SEC review relations of a filing",
+      "params": [
+        {
+          "name": "direction",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "from",
+            "to",
+            "both"
+          ],
+          "example": "both",
+          "description": "Relations from, to or both (default both)"
+        },
+        {
+          "name": "kind",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "text_twin_of",
+            "responds_to",
+            "reviews_filing",
+            "continues_review"
+          ],
+          "example": "responds_to",
+          "description": "One relation kind"
+        },
+        {
+          "name": "history",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "false",
+          "description": "Add superseded observations (`true` or `false`)"
+        },
+        {
+          "name": "cursor",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "MTIz",
+          "description": "Opaque cursor of the previous page (`next_cursor`; follow `next_url`). Bound to the other filters."
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 100,
+          "example": 5,
+          "description": "Relations per page (1-200, default 100)"
+        },
+        {
+          "name": "accession",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "0000320193-26-000026",
+          "description": "Accession number, dashed (0000320193-26-000026) or 18 digits"
+        }
+      ],
+      "view": "json",
+      "pagination": "top",
+      "allItemsPath": [
+        "relations"
+      ]
+    },
+    {
+      "operationId": "secSearch",
+      "group": "sec",
+      "action": "search",
+      "method": "get",
+      "path": "/v1/sec/search",
+      "auth": true,
+      "summary": "Search SEC documents",
+      "params": [
+        {
+          "name": "q",
+          "in": "query",
+          "required": true,
+          "type": "string",
+          "example": "supply chain concentration",
+          "description": "Keywords / a quoted phrase (lexical) or the exact text (literal)",
+          "alias": "q"
+        },
+        {
+          "name": "mode",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "lexical",
+            "literal"
+          ],
+          "example": "lexical",
+          "description": "`lexical` (default) or `literal`",
+          "alias": "m"
+        },
+        {
+          "name": "case_sensitive",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "false",
+          "description": "Literal only: `false` folds case (default case-sensitive)"
+        },
+        {
+          "name": "cik",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "320193",
+          "description": "Filer CIKs, a comma list",
+          "alias": "c"
+        },
+        {
+          "name": "entity_id",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "example": 1,
+          "description": "A company entity id (all its CIKs)"
+        },
+        {
+          "name": "successors",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "false",
+          "description": "Widen `cik` / `entity_id` over reviewed legal successors (`true` or `false`)"
+        },
+        {
+          "name": "accession",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "0000320193-26-000026",
+          "description": "Accession numbers, a comma list"
+        },
+        {
+          "name": "version_id",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "8be0b759-1a9d-5f89-8308-bd86185f5e1f",
+          "description": "Document version ids, a comma list"
+        },
+        {
+          "name": "form",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "10-K",
+          "description": "Form types, a comma list",
+          "alias": "f"
+        },
+        {
+          "name": "filename",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "aapl-20260926.htm",
+          "description": "Document file names, a comma list"
+        },
+        {
+          "name": "item",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2.02",
+          "description": "8-K items, a comma list (e.g. 2.02)"
+        },
+        {
+          "name": "exhibit_type",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "EX-99.1",
+          "description": "Exhibit types, a comma list (e.g. EX-99.1)"
+        },
+        {
+          "name": "filed_from",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2025-01-01",
+          "description": "First filing day (YYYY-MM-DD)"
+        },
+        {
+          "name": "filed_to",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "2026-11-05",
+          "description": "Last filing day (YYYY-MM-DD)"
+        },
+        {
+          "name": "cursor",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "eyJ2IjoxLCJhZnRlciI6WyIyMDI1LTEwLTMxIiwiMDAwMDMyMDE5My0yNS0wMDAwNzkiXSwiZiI6Ijg1NzNiMDg0ZjEyNzVjMjMifQ",
+          "description": "Opaque cursor of the previous page (`next_cursor`; follow `next_url`). Bound to the other filters."
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 20,
+          "example": 5,
+          "description": "Hits per page (1-50, default 20)",
+          "alias": "l"
+        }
+      ],
+      "view": "json",
+      "pagination": "top",
+      "allItemsPath": [
+        "hits"
+      ]
+    },
+    {
+      "operationId": "secDocumentSections",
+      "group": "sec",
+      "action": "sections",
+      "method": "get",
+      "path": "/v1/sec/versions/{version_id}/sections",
+      "auth": true,
+      "summary": "Sections of an SEC document version",
+      "params": [
+        {
+          "name": "outline",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "legacy",
+            "generic"
+          ],
+          "example": "legacy",
+          "description": "One outline only",
+          "alias": "o"
+        },
+        {
+          "name": "version_id",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "8be0b759-1a9d-5f89-8308-bd86185f5e1f",
+          "description": "An immutable document version (`version.version_id` of a document read, a search hit's citation)"
+        }
+      ],
+      "view": "table",
+      "rowsPath": "sections",
+      "columns": [
+        "outline",
+        "ordinal",
+        "legacy_section_key",
+        "title",
+        "blocks"
+      ],
+      "pagination": "none"
+    },
+    {
+      "operationId": "secFinancialsStatement",
+      "group": "sec",
+      "action": "statement",
+      "method": "get",
+      "path": "/v1/sec/financials/{cik}/statements/{statement}",
+      "auth": true,
+      "summary": "Standardized statement with provenance",
+      "params": [
+        {
+          "name": "period_type",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "quarterly",
+            "annual",
+            "ytd",
+            "ttm"
+          ],
+          "example": "annual",
+          "description": "Period type (default annual)",
+          "alias": "p"
+        },
+        {
+          "name": "fiscal_year_from",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "example": 2022,
+          "description": "First fiscal year"
+        },
+        {
+          "name": "fiscal_year_to",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "example": 2026,
+          "description": "Last fiscal year"
+        },
+        {
+          "name": "metric_id",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "is_total_revenue,is_net_income",
+          "description": "Standardized metrics, a comma list"
+        },
+        {
+          "name": "other_evidence",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "false",
+          "description": "Add facts that did not win a cell (`true` or `false`)"
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "default": 2000,
+          "example": 200,
+          "description": "Cells at most (1-5000, default 2000)"
+        },
+        {
+          "name": "cik",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "320193",
+          "description": "CIK of the company"
+        },
+        {
+          "name": "statement",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "enum": [
+            "income_statement",
+            "balance_sheet",
+            "cash_flow_statement"
+          ],
+          "example": "income_statement",
+          "description": "The statement"
+        }
+      ],
+      "view": "json",
+      "pagination": "none"
+    },
+    {
+      "operationId": "secDocumentVersion",
+      "group": "sec",
+      "action": "version",
+      "method": "get",
+      "path": "/v1/sec/versions/{version_id}",
+      "auth": true,
+      "summary": "SEC document version",
+      "params": [
+        {
+          "name": "blocks",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "b00107-b00244",
+          "description": "A block id or range (`b00107` or `b00107-b00244`; a section's `blocks` selector)",
+          "alias": "b"
+        },
+        {
+          "name": "pages",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "1-3",
+          "description": "Physical page ordinals (`3` or `3-5`)",
+          "alias": "p"
+        },
+        {
+          "name": "printed",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "example": "17",
+          "description": "An exact printed page label (`F-7`, `iv`, `12`): compared as the string printed, never as a number"
+        },
+        {
+          "name": "printed_occurrence",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "example": 1,
+          "description": "Which page carrying a repeated printed label (1-based, page order)"
+        },
+        {
+          "name": "neighbors",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "example": 1,
+          "description": "Widen the selection by this many blocks on each side (same version)"
+        },
+        {
+          "name": "footnotes",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "true",
+          "description": "Add the footnote blocks the selection links to (same version) (`true` or `false`)"
+        },
+        {
+          "name": "limit",
+          "in": "query",
+          "required": false,
+          "type": "integer",
+          "example": 5,
+          "description": "At most this many blocks (1-1000); the answer names the next block when cut",
+          "alias": "l"
+        },
+        {
+          "name": "version_id",
+          "in": "path",
+          "required": true,
+          "type": "string",
+          "example": "8be0b759-1a9d-5f89-8308-bd86185f5e1f",
+          "description": "An immutable document version (`version.version_id` of a document read, a search hit's citation)"
+        }
+      ],
+      "view": "json",
+      "pagination": "none"
+    },
     {
       "operationId": "segmentedFinancials",
       "group": "segments",