Previous value: -"Data-completeness warnings specific to this query. Populated for duration periods 'CY####Q[1-4]', where SEC XBRL omits filers' fiscal Q4 (reported only as the 10-K residual) — affected filers are silently absent from the frame. Populated for annual ('CY####') NetIncomeLoss frames, where a filer's row can be its proxy statement's pay-versus-performance figure rather than the 10-K's. Populated for an annual frame whose calendar year is still open or inside its 10-K filing window, where a filer's row can be a trailing-twelve-month figure from a 10-Q rather than a fiscal year. Also flags a value distribution whose top rows look like split or scale-factor artifacts. Otherwise empty."New value: +"Completeness warnings, else empty: quarterly frames (CY####Q#) omit fiscal-Q4 filers; annual NetIncomeLoss rows may be proxy pay-versus-performance figures; an annual frame still open or in its 10-K window may hold 10-Q trailing-twelve-month figures; top rows may be split or scale artifacts."

Previous value: -"Business location (state or country). Absent when SEC has no location for this filer."New value: +"Business location (state or country). Absent when SEC has none."

Previous value: -"Canvas dataframe handle holding the full frames response. Absent when canvas is unavailable or materialization failed."New value: +"Dataframe of the full frame, every reporter. Absent when canvas is unavailable or staging failed."

Previous value: -"Dataframe handle (df_XXXXX_XXXXX) — inspect its columns with secedgar_dataframe_describe, then query it with secedgar_dataframe_query."New value: +"Dataframe handle (df_XXXXX_XXXXX) for secedgar_dataframe_describe, then secedgar_dataframe_query."

Previous value: -"Offset to pass on the next call to continue down the ranking. Absent on the last page (no companies remain past this one)."New value: +"Offset for the next page down the ranking. Absent on the last page."

Previous value: -"Rank the returned page starts at, 0-based — the effective offset applied."New value: +"Rank the returned page starts at, 0-based."

Previous value: -"Range of period_end dates across the frame. SEC normalizes to calendar periods but filers report against their own fiscal year-ends, so a \"CY2023\" duration frame can contain period_ends from 2023-01-31 (January-FY filers like Walmart) to 2024-12-31 (calendar-FY filers reported late). Wide ranges mean cross-comparison mixes fiscal periods."New value: +"Range of period_end dates; filers report on their own fiscal years, so \"CY2023\" can span 2023-01-31 to 2024-12-31, mixing fiscal periods."

Previous value: -"Alternate-DEFINITION XBRL tags (distinct from same-meaning `unqueried_tags`) that a meaningful share of filers use as their primary line for this metric — e.g. `cash` filers reporting `CashCashEquivalentsRestrictedCashAndRestrictedCashEquivalents` (incl. restricted cash), `equity` filers reporting `StockholdersEquityIncludingPortionAttributableToNoncontrollingInterest` (incl. noncontrolling interest). These filers are NOT in `data` or the dataframe, so a whole-universe screen on the base tag silently under-counts. To recover them, run a separate fetch_frames against the alternate tag — do NOT blindly UNION (definitions differ; you would mix or double-count). Empty when the concept has no known high-coverage alternate."New value: +"Alternate-definition tags many filers use as their primary line (e.g., cash including restricted cash); those filers are absent from data. Fetch each separately; never blindly UNION, since definitions differ. Empty when none is known."

Previous value: -"Alternate XBRL tag a meaningful share of filers report this metric under instead."New value: +"Alternate XBRL tag those filers report under."

Previous value: -"Frames namespace the tag was read from (us-gaap or dei) — a friendly name mapped to dei reads dei under the us-gaap default."New value: +"Frames namespace the tag was read from (us-gaap or dei); a friendly name mapped to dei reads dei."

Previous value: -"Unit of measure used for the lookup (always normalized to dashed form, e.g. \"USD-per-shares\")."New value: +"Unit of measure, in dashed form (e.g., \"USD-per-shares\")."

Previous value: -"Other same-meaning XBRL tags in the friendly-name mapping that this call did NOT query (historical/variant spellings of the same metric). Empty for raw tags or single-tag concepts — for alternate-DEFINITION tags some filers use instead, see `related_tags`. For \"revenue\" this typically lists `Revenues`, `SalesRevenueNet`, `SalesRevenueGoodsNet` — filers reporting under legacy variants are absent from `data`; call again per tag and UNION/COALESCE in SQL to recover them."New value: +"Same-meaning mapped tags this call did not query (e.g., SalesRevenueNet for revenue); their filers are absent from data, so fetch each and UNION/COALESCE in SQL. Empty for raw tags and single-tag concepts."

Previous value: -"Distribution stats across the full frame, computed during materialization. Use `max_to_p95_ratio` as the primary outlier signal — it catches scale-factor anomalies even when median is 0 or negative."New value: +"Distribution across the full frame; max_to_p95_ratio is the outlier signal."

Previous value: -"Maximum value divided by 95th percentile. Robust to zero/negative bulk (unlike median-based ratios — many frames have median = 0 or negative, e.g. EPS with many loss-making filers). Typical heavy-tail frames sit in the 10–50× range (mega-caps over the rest); ratios above ~200× usually indicate a filer-side XBRL scale-factor error (wrong `decimals` attribute) — verify the topmost row(s) in `data` before trusting absolute rankings."New value: +"Max divided by p95. Heavy-tail frames sit near 10–50×; above ~200× usually means a filer-side scale-factor error, so check the top rows of data before trusting rankings."

Added value: +{
+  "default": "us-gaap",
+  "description": "Frames namespace a raw XBRL tag is read from: us-gaap for financial-statement tags, dei for cover-page entity tags such as EntityCommonStockSharesOutstanding. SEC publishes frames for no other taxonomy. A friendly name keeps its own mapped taxonomy (shares_outstanding reads dei) unless dei is passed, which reads its tags from dei instead — the same rule as secedgar_get_financials.",
+  "enum": [
+    "us-gaap",
+    "dei"
+  ],
+  "type": "string"
+}

Previous value: -[
-  {
-    "not": {
-      "required": [
-        "error"
-      ]
-    },
-    "required": [
-      "concept",
-      "period",
-      "unit",
-      "label",
-      "total_companies",
-      "offset",
-      "data",
-      "unqueried_tags",
-      "related_tags",
-      "value_distribution",
-      "period_end_range",
-      "caveats"
-    ]
-  },
-  {
-    "required": [
-      "error"
-    ]
-  }
-]New value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "concept",
+      "taxonomy",
+      "period",
+      "unit",
+      "label",
+      "total_companies",
+      "offset",
+      "data",
+      "unqueried_tags",
+      "related_tags",
+      "value_distribution",
+      "period_end_range",
+      "caveats"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Previous value: -"Data-completeness warnings specific to this query. Currently populated for duration periods 'CY####Q[1-4]', where SEC XBRL omits filers' fiscal Q4 (reported only as the 10-K residual) — affected filers are silently absent from the frame. Empty for annual ('CY####') and instant ('CY####Q#I') periods, where the underlying facts exist and the frame is complete."New value: +"Data-completeness warnings specific to this query. Populated for duration periods 'CY####Q[1-4]', where SEC XBRL omits filers' fiscal Q4 (reported only as the 10-K residual) — affected filers are silently absent from the frame. Populated for annual ('CY####') NetIncomeLoss frames, where a filer's row can be its proxy statement's pay-versus-performance figure rather than the 10-K's. Populated for an annual frame whose calendar year is still open or inside its 10-K filing window, where a filer's row can be a trailing-twelve-month figure from a 10-Q rather than a fiscal year. Also flags a value distribution whose top rows look like split or scale-factor artifacts. Otherwise empty."

Previous value: -"Machine-readable failure mode. Declared by this tool: `unknown_concept`: The concept input does not match a friendly name and SEC frames returned no data. `no_data`: Concept resolves but no companies report this metric for the requested period and unit. `rate_limited`: SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `unknown_concept`: The concept input is neither a supported friendly name nor shaped like an XBRL tag, so no request is sent. `no_data`: Concept resolves but no companies report this metric for the requested period and unit. `rate_limited`: SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs. Other values are possible when a failure originates below the handler."

Added value: +{
+  "description": "Frames namespace the tag was read from (us-gaap or dei) — a friendly name mapped to dei reads dei under the us-gaap default.",
+  "type": "string"
+}

Previous value: -"Machine-readable failure mode. Declared by this tool: `unknown_concept`: The concept input does not match a friendly name and SEC frames returned no data `no_data`: Concept resolves but no companies report this metric for the requested period and unit Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `unknown_concept`: The concept input does not match a friendly name and SEC frames returned no data. `no_data`: Concept resolves but no companies report this metric for the requested period and unit. `rate_limited`: SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "unknown_concept",
-  "no_data"
-]New value: +[
+  "unknown_concept",
+  "no_data",
+  "rate_limited"
+]

Previous value: -"Dataframe handle (df_XXXXX_XXXXX) — pass to secedgar_dataframe_query."New value: +"Dataframe handle (df_XXXXX_XXXXX) — inspect its columns with secedgar_dataframe_describe, then query it with secedgar_dataframe_query."

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "concept",
+      "period",
+      "unit",
+      "label",
+      "total_companies",
+      "offset",
+      "data",
+      "unqueried_tags",
+      "related_tags",
+      "value_distribution",
+      "period_end_range",
+      "caveats"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `unknown_concept`: The concept input does not match a friendly name and SEC frames returned no data `no_data`: Concept resolves but no companies report this metric for the requested period and unit Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "unknown_concept",
+            "no_data"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "concept",
-  "period",
-  "unit",
-  "label",
-  "total_companies",
-  "offset",
-  "data",
-  "unqueried_tags",
-  "related_tags",
-  "value_distribution",
-  "period_end_range",
-  "caveats"
-]

Added value: +{
+  "default": 0,
+  "description": "Rank to start the page at, 0-based, over the sorted frame. Pass the next_offset from the previous response to read the next page — the ranked list is fetched whole and sliced, so paging is stable and gap-free. An offset at or past total_companies returns an empty page.",
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "description": "Offset to pass on the next call to continue down the ranking. Absent on the last page (no companies remain past this one).",
+  "type": "number"
+}

Added value: +{
+  "description": "Guidance when the requested offset lands past the end of the ranked list.",
+  "type": "string"
+}

Added value: +{
+  "description": "Rank the returned page starts at, 0-based — the effective offset applied.",
+  "type": "number"
+}

Previous value: -[
-  "concept",
-  "period",
-  "unit",
-  "label",
-  "total_companies",
-  "data",
-  "unqueried_tags",
-  "related_tags",
-  "value_distribution",
-  "period_end_range",
-  "caveats"
-]New value: +[
+  "concept",
+  "period",
+  "unit",
+  "label",
+  "total_companies",
+  "offset",
+  "data",
+  "unqueried_tags",
+  "related_tags",
+  "value_distribution",
+  "period_end_range",
+  "caveats"
+]

Added value: +{
+  "description": "The limit cap applied.",
+  "type": "number"
+}

Added value: +{
+  "description": "Number of companies shown inline.",
+  "type": "number"
+}

Added value: +{
+  "description": "True when the inline data[] was capped by limit.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Alternate-DEFINITION XBRL tags (distinct from same-meaning `unqueried_tags`) that a meaningful share of filers use as their primary line for this metric — e.g. `cash` filers reporting `CashCashEquivalentsRestrictedCashAndRestrictedCashEquivalents` (incl. restricted cash), `equity` filers reporting `StockholdersEquityIncludingPortionAttributableToNoncontrollingInterest` (incl. noncontrolling interest). These filers are NOT in `data` or the dataframe, so a whole-universe screen on the base tag silently under-counts. To recover them, run a separate fetch_frames against the alternate tag — do NOT blindly UNION (definitions differ; you would mix or double-count). Empty when the concept has no known high-coverage alternate.",
+  "items": {
+    "additionalProperties": false,
+    "description": "One alternate-definition tag and the reason it differs.",
+    "properties": {
+      "note": {
+        "description": "How this tag differs in definition from the queried tag.",
+        "type": "string"
+      },
+      "tag": {
+        "description": "Alternate XBRL tag a meaningful share of filers report this metric under instead.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "tag",
+      "note"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Previous value: -"Other XBRL tags in the same friendly-name mapping that this call did NOT query. Empty for raw tags or single-tag concepts. For \"revenue\" this typically lists `Revenues`, `SalesRevenueNet`, `SalesRevenueGoodsNet` — filers reporting under legacy variants are absent from `data`; call again per tag and UNION/COALESCE in SQL to recover them."New value: +"Other same-meaning XBRL tags in the friendly-name mapping that this call did NOT query (historical/variant spellings of the same metric). Empty for raw tags or single-tag concepts — for alternate-DEFINITION tags some filers use instead, see `related_tags`. For \"revenue\" this typically lists `Revenues`, `SalesRevenueNet`, `SalesRevenueGoodsNet` — filers reporting under legacy variants are absent from `data`; call again per tag and UNION/COALESCE in SQL to recover them."

Previous value: -[
-  "concept",
-  "period",
-  "unit",
-  "label",
-  "total_companies",
-  "data",
-  "unqueried_tags",
-  "value_distribution",
-  "period_end_range",
-  "caveats"
-]New value: +[
+  "concept",
+  "period",
+  "unit",
+  "label",
+  "total_companies",
+  "data",
+  "unqueried_tags",
+  "related_tags",
+  "value_distribution",
+  "period_end_range",
+  "caveats"
+]

Added value: +"^CY\\d{4}(Q[1-4]I?)?$"

Added value: +1

Added value: +1