@invinite-org/invinite-data-cli 4.0.0 → 5.0.0

package/README.md

@@ -13,7 +13,9 @@ invd holdings AAPL
 invd search filings "supply chain risk" --company AAPL
 ```
 
-Version 4.0 is a new command surface over the v2 API. Coming from 3.x, read [Upgrading from 3.x](#upgrading-from-3x).
+Version 5.0 calls the API at its final `/v1` paths (the 2026-11-11 cut-over moved the redesigned API from `/v2` to
+`/v1` and deleted the old v1); its commands are the 4.0 commands. Coming from 4.x, read
+[Upgrading from 4.x](#upgrading-from-4x); from 3.x, [Upgrading from 3.x](#upgrading-from-3x).
 
 ## Installation
 
@@ -58,7 +60,7 @@ The active key is resolved in this order:
 5. `api_key` in the global `config.toml`
 
 ```bash
-curl -H "Authorization: Bearer $(invd auth token)" https://api.data.invinite.com/v2/me
+curl -H "Authorization: Bearer $(invd auth token)" https://api.data.invinite.com/v1/me
 ```
 
 ## The command grammar
@@ -110,7 +112,7 @@ invd events transcript <event_id>
 and `invd events AAPL` lists Apple's calls.
 
 **Events by fiscal period.** Every command that takes an `event_id` also takes a company and a fiscal period in its
-place; invd resolves the event through `GET /v2/events` and says so on stderr:
+place; invd resolves the event through `GET /v1/events` and says so on stderr:
 
 ```bash
 invd events transcript NVDA 2026Q3
@@ -327,12 +329,12 @@ invd investor-documents get <document_id> --save report.pdf
 The escape hatch for anything the command tree lacks:
 
 ```bash
-invd api /v2/companies/AAPL
-invd api GET /v2/filings?company=AAPL --paginate --jq '.data[].accession'
-invd api GET /v2/holdings -F company=AAPL -F limit=100
-invd api POST /v2/webhooks --input webhook.json
-invd api DELETE /v2/webhooks/<id> --yes
-invd api GET /v2/me -H 'Accept: application/json' --dry-run
+invd api /v1/companies/AAPL
+invd api GET /v1/filings?company=AAPL --paginate --jq '.data[].accession'
+invd api GET /v1/holdings -F company=AAPL -F limit=100
+invd api POST /v1/webhooks --input webhook.json
+invd api DELETE /v1/webhooks/<id> --yes
+invd api GET /v1/me -H 'Accept: application/json' --dry-run
 ```
 
 `-F key=value` is typed (numbers, `true` / `false`, `null`, `@file`), `-f key=value` always a string; both are query
@@ -418,7 +420,7 @@ invd completion bash > ~/.local/share/bash-completion/completions/invd
 invd completion fish > ~/.config/fish/completions/invd.fish
 ```
 
-Completion covers commands, flags, and the `/v2` paths after `invd api`.
+Completion covers commands, flags, and the `/v1` paths after `invd api`.
 
 ## Exit codes
 
@@ -432,9 +434,15 @@ Completion covers commands, flags, and the `/v2` paths after `invd api`.
 | 5 | integrity: a download's checksum or size does not match |
 | 6 | credits exhausted or plan required: 402, `plan_required`, `insufficient_credits` |
 
+## Upgrading from 4.x
+
+5.0 keeps every 4.x command, flag, output and exit code; only the request paths moved from `/v2/...` to `/v1/...`
+(the API's 2026-11-11 cut-over; `/v2/*` answers 404 since, so 4.x no longer works). `invd api` paths are `/v1/...`
+now. Upgrade = install 5.0.
+
 ## Upgrading from 3.x
 
-4.0 replaces the v1 command tree with the v2 noun-verb grammar. No 3.x spelling is kept as an alias.
+4.0 replaced the old v1 command tree with the noun-verb grammar (5.0 keeps it). No 3.x spelling is kept as an alias.
 
 | 3.x | 4.0 |
 |---|---|
@@ -451,21 +459,15 @@ Completion covers commands, flags, and the `/v2` paths after `invd api`.
 | `sec filings\|filing\|document\|sections\|search` | `invd filings list\|get`, `invd documents get\|sections`, `invd search filings` |
 | `ownership …` | `invd holdings list\|changes` |
 | `usage` | `invd me usage` |
-| `ws listen` (WebSocket stream) | no CLI command in 4.0; use the API's `/v2/stream` |
+| `ws listen` (WebSocket stream) | no CLI command in 4.0; use the API's `/v1/stream` |
 | `-i, --identifier AAPL` | the positional company: `invd filings AAPL` |
 | `--offset <n>` | `--cursor <next_cursor>` |
 | `INVINITE_DATA_API_KEY` | still read; `INVD_API_KEY` takes precedence |
 
-### invd 3.x maintenance
-
-invd 3.x is the CLI of the v1 API and stays installable:
-
-```bash
-npm install -g @invinite-org/invinite-data-cli@3
-```
+### Older majors
 
-The v1 API keeps working until it is deleted. 3.x fixes are cut from the `cli-3.x` maintenance branch, started at the
-3.0.0 commit `9bbdb29`, never from `main`.
+invd 3.x (the old v1 API) and 4.x (the `/v2` paths) call routes that were deleted on 2026-11-11; neither works
+against the live API any more. Install 5.x.
 
 ## Development
 

package/claude-plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "invinite-financial-data",
   "description": "Fetch and analyze financial data using the Invinite Data API — company fundamentals, financial statements, SEC filings, earnings calls (transcripts, guidance, Q&A, live calls), company news, institutional ownership, insider trades, and more.",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "author": {
     "name": "Invinite"
   },

package/claude-plugin/agents/invinite-data.md

@@ -44,7 +44,7 @@ the `invd` CLI (version 4, the v2 API) and return it in a clean, structured form
 - Exit 4 = no or invalid key: report it and tell the caller to run `invd auth login` (or set `INVD_API_KEY`).
   Exit 6 = credits exhausted or plan required: report the plan or credit message as given.
 - Never pass `--save` unless the caller asked for a file.
-- When the command tree lacks an operation, `invd api GET /v2/<path>` reaches it (it prints JSON).
+- When the command tree lacks an operation, `invd api GET /v1/<path>` reaches it (it prints JSON).
 
 ## MCP equivalents
 

package/claude-plugin/skills/invinite-data-cli/SKILL.md

@@ -39,7 +39,7 @@ serves the earlier roster; use whatever tools it lists, or the CLI.
 | News items, text, announcements, news search | `get_news` | `invd news list\|get\|text\|announcements`, `invd search news` |
 | Account and usage | `get_account` | `invd me show\|usage` |
 | Webhooks | `manage_webhooks` | `invd webhooks …` |
-| Any other operation | `search_endpoints` + `call_api` | `invd api GET /v2/…` |
+| Any other operation | `search_endpoints` + `call_api` | `invd api GET /v1/…` |
 
 MCP resources `invinite://catalog/metrics`, `invinite://catalog/sections`, `invinite://catalog/event-types`,
 `invinite://catalog/forms` and `invinite://catalog/document-kinds` are the catalogs (`invd catalog metrics`, `invd catalog sections`, `invd catalog event-types`, `invd catalog forms`,
@@ -74,10 +74,10 @@ An auth failure exits 4: reconnect the MCP connector, or tell the user to run `i
   `invd financials AAPL MSFT`), the member id on member commands (`invd companies get AAPL`,
   `invd filings get 0000320193-26-000026`, `invd events transcript <event_id>`).
 - Every command that takes an `event_id` also takes a company plus a fiscal period: `invd events transcript NVDA 2026Q3`
-  resolves the event through `GET /v2/events` (one extra credit; the resolution is noted on stderr).
+  resolves the event through `GET /v1/events` (one extra credit; the resolution is noted on stderr).
 - Flags are the API parameters with dashes (`fiscal_year` → `--fiscal-year`, `filed_at[gte]` → `--filed-at-gte`).
   `invd <group> <action> --help` lists them with the API's descriptions, the credit cost and plan, and the row fields.
-- `invd api` calls any path the tree lacks: `invd api GET /v2/filings?company=AAPL --paginate --jq '.data[].accession'`.
+- `invd api` calls any path the tree lacks: `invd api GET /v1/filings?company=AAPL --paginate --jq '.data[].accession'`.
 
 ## Output, pagination and cost
 
@@ -251,10 +251,10 @@ invd agent-setup --all --global --dry-run   # print what would be written
 
 <!-- invd:hand:api -->
 ```bash
-invd api /v2/companies/AAPL
-invd api GET /v2/filings?company=AAPL --paginate --jq '.data[].accession'
-invd api GET /v2/holdings -F company=AAPL -F limit=100 --dry-run
-invd api POST /v2/webhooks --input webhook.json
+invd api /v1/companies/AAPL
+invd api GET /v1/filings?company=AAPL --paginate --jq '.data[].accession'
+invd api GET /v1/holdings -F company=AAPL -F limit=100 --dry-run
+invd api POST /v1/webhooks --input webhook.json
 ```
 <!-- /invd:hand:api -->
 
@@ -499,7 +499,7 @@ invd investor-documents list AAPL --json
 
 ### ipos
 
-Initial public offerings
+Offerings from registration to listing
 
 ```bash
 # Get an offering (optional: --fields)
@@ -520,7 +520,7 @@ invd market holidays --json
 
 ### me
 
-Your data account's own usage (costs no credits)
+The caller's account and usage (0 credits)
 
 ```bash
 # Who am I
@@ -550,7 +550,7 @@ invd metrics ratios AAPL -p annual --json
 
 ### news
 
-News of US companies from SEC filings and their own newsrooms: items, full text with attribution, developments and files
+News items, full text, search and announcements
 
 ```bash
 # List announcements (optional: --topic, --item, --announced-at-gte, --announced-at-gt, --announced-at-lte, --announced-at-lt, --effective-from-gte, --effective-to-lte, --sort, --fields, --limit, --cursor, --all)
@@ -623,7 +623,7 @@ invd segments list-detailed AAPL -p annual --json
 
 ### webhooks
 
-Outbound earnings-call lifecycle deliveries (LITE and above)
+Outbound event deliveries
 
 ```bash
 # Create a webhook (optional: --idempotency-key, --url, --events, --ciks, --keywords, --body, --body-file)

package/dist/src/cli.js

@@ -65,7 +65,7 @@ export function createProgram() {
     applyColorEnv();
     program
         .name('invd')
-        .description('CLI for the Invinite financial data API (v2)')
+        .description('CLI for the Invinite financial data API (v1)')
         .version(packageVersion(), '-V, --version')
         // Root options only before the subcommand: an operation's own `--version` (a transcript version) is its own.
         .enablePositionalOptions()

package/dist/src/client/api-client.d.ts

@@ -1,7 +1,7 @@
 export type QueryValue = string | string[] | undefined;
 export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 export interface RequestOptions {
-    /** A path under the base URL (`/v2/filings`); a query string on it is kept. */
+    /** A path under the base URL (`/v1/filings`); a query string on it is kept. */
     path: string;
     method?: HttpMethod;
     /** An array value is sent as a repeated parameter (`a=1&a=2`); `undefined` / `''` are dropped. */

package/dist/src/commands/api.d.ts

@@ -20,7 +20,7 @@ interface ApiOpts {
 export declare function apiRequestFrom(first: string, second: string | undefined, opts: ApiOpts): Promise<RequestOptions>;
 /**
  * `invd api`: any operation of the spec, raw. `--paginate` follows `next_cursor` / `Link rel="next"` and prints
- * every page (each through `--jq`), so `invd api /v2/filings?company=AAPL --paginate --jq '.data[].accession'`
+ * every page (each through `--jq`), so `invd api /v1/filings?company=AAPL --paginate --jq '.data[].accession'`
  * streams accessions.
  */
 export declare function registerApiCommand(program: Command): void;

package/dist/src/commands/api.js

@@ -39,7 +39,7 @@ export function apiPathOf(rawPath, baseUrl = getBaseUrl()) {
         throw new UsageError(`${rawPath} is not a URL or an API path`);
     }
     if (target.origin !== base.origin) {
-        throw new UsageError(`invd api only calls ${base.origin} (the request carries your API key); refusing ${target.origin}. Pass a path such as /v2/companies/AAPL`);
+        throw new UsageError(`invd api only calls ${base.origin} (the request carries your API key); refusing ${target.origin}. Pass a path such as /v1/companies/AAPL`);
     }
     const prefix = base.pathname.replace(/\/+$/, '');
     const path = prefix && target.pathname.startsWith(`${prefix}/`) ? target.pathname.slice(prefix.length) : target.pathname;
@@ -60,7 +60,7 @@ export async function apiRequestFrom(first, second, opts) {
     if (!METHODS.includes(method))
         throw new UsageError(`${first} is not an HTTP method (${METHODS.join(', ')})`);
     if (!rawPath)
-        throw new UsageError('invd api needs a path, e.g. invd api /v2/companies/AAPL');
+        throw new UsageError('invd api needs a path, e.g. invd api /v1/companies/AAPL');
     const url = new URL(apiPathOf(rawPath), 'http://placeholder');
     const query = {};
     url.searchParams.forEach((value, key) => { (query[key] ??= []).push(value); });
@@ -111,7 +111,7 @@ function print(body, jq) {
 }
 /**
  * `invd api`: any operation of the spec, raw. `--paginate` follows `next_cursor` / `Link rel="next"` and prints
- * every page (each through `--jq`), so `invd api /v2/filings?company=AAPL --paginate --jq '.data[].accession'`
+ * every page (each through `--jq`), so `invd api /v1/filings?company=AAPL --paginate --jq '.data[].accession'`
  * streams accessions.
  */
 export function registerApiCommand(program) {
@@ -119,7 +119,7 @@ export function registerApiCommand(program) {
         .command('api')
         .description('Call any API path directly (the escape hatch for anything the command tree lacks)')
         .argument('<method-or-path>', 'GET (default), POST, PATCH, DELETE … or the path')
-        .argument('[path]', 'The path when a method is given, e.g. /v2/filings?company=AAPL')
+        .argument('[path]', 'The path when a method is given, e.g. /v1/filings?company=AAPL')
         .option('-F, --field <key=value>', 'A parameter (query on GET / DELETE, JSON body field otherwise); typed: numbers, true / false, null, @file', collect, [])
         .option('-f, --raw-field <key=value>', 'Like -F, always a string', collect, [])
         .option('-H, --header <name:value>', 'An extra request header', collect, [])
@@ -132,11 +132,11 @@ export function registerApiCommand(program) {
         .option('--show-cost', 'Print the credits this command cost to stderr')
         .addHelpText('before', [
         'Examples:',
-        '  $ invd api /v2/companies/AAPL',
-        "  $ invd api GET /v2/filings?company=AAPL --paginate --jq '.data[].accession'",
+        '  $ invd api /v1/companies/AAPL',
+        "  $ invd api GET /v1/filings?company=AAPL --paginate --jq '.data[].accession'",
         '',
     ].join('\n'))
-        .addHelpText('after', '\nPaths: invd completion <shell> completes every /v2 path of the spec after `invd api`.\n')
+        .addHelpText('after', '\nPaths: invd completion <shell> completes every /v1 path of the spec after `invd api`.\n')
         .action(withErrorHandling(async (first, second, _raw, command) => {
         const opts = command.opts();
         // commander keeps --input <file> and --no-input in one attribute: a string is the file, false the switch.

package/dist/src/commands/auth.d.ts

@@ -28,7 +28,7 @@ export declare function login(dependencies?: LoginDependencies, opts?: {
     noBrowser?: boolean;
 }): Promise<ExchangeData>;
 export declare function logout(dependencies?: Pick<LoginDependencies, 'fetch'>): Promise<void>;
-/** `invd auth status`: where the key comes from and, unless `offline`, what `GET /v2/me` says about it (free). */
+/** `invd auth status`: where the key comes from and, unless `offline`, what `GET /v1/me` says about it (free). */
 export declare function status(opts?: {
     offline?: boolean;
     json?: boolean;

package/dist/src/commands/auth.js

@@ -263,7 +263,7 @@ export async function logout(dependencies = defaultDependencies) {
     await clearApiKey();
     console.log(chalk.green('Logged out locally.'));
 }
-/** `invd auth status`: where the key comes from and, unless `offline`, what `GET /v2/me` says about it (free). */
+/** `invd auth status`: where the key comes from and, unless `offline`, what `GET /v1/me` says about it (free). */
 export async function status(opts = {}) {
     const resolved = await resolveApiKey();
     const summary = {
@@ -273,7 +273,7 @@ export async function status(opts = {}) {
         origin: resolved.origin,
     };
     if (!opts.offline) {
-        const { body } = await apiCall({ path: '/v2/me', silent: true });
+        const { body } = await apiCall({ path: '/v1/me', silent: true });
         const account = body?.account;
         const plan = body?.plan;
         if (typeof account === 'object' && account !== null) {
@@ -315,7 +315,7 @@ export function registerAuthCommands(program) {
     }));
     auth
         .command('status')
-        .description('Show which key is active, where it comes from, and the account it belongs to (GET /v2/me, free)')
+        .description('Show which key is active, where it comes from, and the account it belongs to (GET /v1/me, free)')
         .option('--offline', 'Do not call the API')
         .option('--json', 'Print JSON')
         .addHelpText('before', 'Examples:\n  $ invd auth status\n  $ invd auth status --offline --json\n')

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

@@ -1,6 +1,6 @@
 {
-  "specVersion": "1.0.0",
-  "specSha256": "cdf746bdb27de5ee43c9e16a2fad8b033f52ceeb870ab9c0fe54b241a0291e5c",
+  "specVersion": "2026-11-11",
+  "specSha256": "e36d0409b4df860d4ebb0c8c1dbd4e6b8c45e232037db027b0a3d862804ebe84",
   "groups": [
     {
       "name": "catalog",
@@ -48,7 +48,7 @@
     },
     {
       "name": "ipos",
-      "description": "Initial public offerings"
+      "description": "Offerings from registration to listing"
     },
     {
       "name": "market",
@@ -56,7 +56,7 @@
     },
     {
       "name": "me",
-      "description": "Your data account's own usage (costs no credits)"
+      "description": "The caller's account and usage (0 credits)"
     },
     {
       "name": "metrics",
@@ -64,7 +64,7 @@
     },
     {
       "name": "news",
-      "description": "News of US companies from SEC filings and their own newsrooms: items, full text with attribution, developments and files"
+      "description": "News items, full text, search and announcements"
     },
     {
       "name": "people",
@@ -80,7 +80,7 @@
     },
     {
       "name": "webhooks",
-      "description": "Outbound earnings-call lifecycle deliveries (LITE and above)"
+      "description": "Outbound event deliveries"
     }
   ],
   "operations": [
@@ -89,7 +89,7 @@
       "group": "catalog",
       "action": "document-kinds",
       "method": "get",
-      "path": "/v2/catalog/document-kinds",
+      "path": "/v1/catalog/document-kinds",
       "auth": true,
       "summary": "List investor-document kinds",
       "credits": 1,
@@ -143,7 +143,7 @@
       "group": "catalog",
       "action": "event-types",
       "method": "get",
-      "path": "/v2/catalog/event-types",
+      "path": "/v1/catalog/event-types",
       "auth": true,
       "summary": "List event types",
       "credits": 1,
@@ -196,7 +196,7 @@
       "group": "catalog",
       "action": "forms",
       "method": "get",
-      "path": "/v2/catalog/forms",
+      "path": "/v1/catalog/forms",
       "auth": true,
       "summary": "List SEC forms",
       "credits": 1,
@@ -249,7 +249,7 @@
       "group": "catalog",
       "action": "mapping-rules",
       "method": "get",
-      "path": "/v2/catalog/mapping-rules",
+      "path": "/v1/catalog/mapping-rules",
       "auth": true,
       "summary": "List standardized mapping rules",
       "credits": 1,
@@ -323,7 +323,7 @@
       "group": "catalog",
       "action": "metrics",
       "method": "get",
-      "path": "/v2/catalog/metrics",
+      "path": "/v1/catalog/metrics",
       "auth": true,
       "summary": "List standardized metrics",
       "credits": 1,
@@ -389,7 +389,7 @@
       "group": "catalog",
       "action": "sections",
       "method": "get",
-      "path": "/v2/catalog/sections",
+      "path": "/v1/catalog/sections",
       "auth": true,
       "summary": "List filing section ids",
       "credits": 1,
@@ -452,7 +452,7 @@
       "group": "companies",
       "action": "dividends",
       "method": "get",
-      "path": "/v2/dividends",
+      "path": "/v1/dividends",
       "auth": true,
       "summary": "List dividends",
       "credits": 1,
@@ -577,7 +577,7 @@
       "group": "companies",
       "action": "fiscal-periods",
       "method": "get",
-      "path": "/v2/fiscal-periods",
+      "path": "/v1/fiscal-periods",
       "auth": true,
       "summary": "List fiscal periods",
       "credits": 1,
@@ -663,7 +663,7 @@
       "group": "companies",
       "action": "get",
       "method": "get",
-      "path": "/v2/companies/{company}",
+      "path": "/v1/companies/{company}",
       "auth": true,
       "summary": "Get a company",
       "credits": 1,
@@ -757,7 +757,7 @@
       "group": "companies",
       "action": "list",
       "method": "get",
-      "path": "/v2/companies",
+      "path": "/v1/companies",
       "auth": true,
       "summary": "List listed companies",
       "credits": 1,
@@ -865,7 +865,7 @@
       "group": "companies",
       "action": "splits",
       "method": "get",
-      "path": "/v2/splits",
+      "path": "/v1/splits",
       "auth": true,
       "summary": "List stock splits",
       "credits": 1,
@@ -948,7 +948,7 @@
       "group": "documents",
       "action": "fact-places",
       "method": "get",
-      "path": "/v2/fact-places",
+      "path": "/v1/fact-places",
       "auth": true,
       "summary": "List where facts appear in a document",
       "credits": 1,
@@ -1039,7 +1039,7 @@
       "group": "documents",
       "action": "figure",
       "method": "get",
-      "path": "/v2/document-versions/{version_id}/figures/{block_id}",
+      "path": "/v1/document-versions/{version_id}/figures/{block_id}",
       "auth": true,
       "summary": "Get a figure",
       "credits": 1,
@@ -1082,7 +1082,7 @@
       "group": "documents",
       "action": "get",
       "method": "get",
-      "path": "/v2/document-versions/{version_id}",
+      "path": "/v1/document-versions/{version_id}",
       "auth": true,
       "summary": "Get a document version",
       "credits": 1,
@@ -1171,7 +1171,7 @@
       "group": "documents",
       "action": "sections",
       "method": "get",
-      "path": "/v2/document-versions/{version_id}/sections",
+      "path": "/v1/document-versions/{version_id}/sections",
       "auth": true,
       "summary": "List a document version's sections",
       "credits": 1,
@@ -1248,7 +1248,7 @@
       "group": "events",
       "action": "audio",
       "method": "get",
-      "path": "/v2/events/{event_id}/audio",
+      "path": "/v1/events/{event_id}/audio",
       "auth": true,
       "summary": "Get an event's recording",
       "credits": 5,
@@ -1285,7 +1285,7 @@
       "group": "events",
       "action": "comparison",
       "method": "get",
-      "path": "/v2/events/{event_id}/comparison",
+      "path": "/v1/events/{event_id}/comparison",
       "auth": true,
       "summary": "Compare an event with a prior one",
       "credits": 1,
@@ -1336,7 +1336,7 @@
       "group": "events",
       "action": "get",
       "method": "get",
-      "path": "/v2/events/{event_id}",
+      "path": "/v1/events/{event_id}",
       "auth": true,
       "summary": "Get an event",
       "credits": 1,
@@ -1421,7 +1421,7 @@
       "group": "events",
       "action": "list",
       "method": "get",
-      "path": "/v2/events",
+      "path": "/v1/events",
       "auth": true,
       "summary": "List events",
       "credits": 1,
@@ -1638,7 +1638,7 @@
       "group": "events",
       "action": "live-audio",
       "method": "get",
-      "path": "/v2/events/{event_id}/live-audio",
+      "path": "/v1/events/{event_id}/live-audio",
       "auth": true,
       "summary": "Get an event's live audio URL",
       "credits": 5,
@@ -1675,7 +1675,7 @@
       "group": "events",
       "action": "press-release",
       "method": "get",
-      "path": "/v2/events/{event_id}/press-release",
+      "path": "/v1/events/{event_id}/press-release",
       "auth": true,
       "summary": "Get an event's press release",
       "credits": 1,
@@ -1715,7 +1715,7 @@
       "group": "events",
       "action": "price-attribution",
       "method": "get",
-      "path": "/v2/events/{event_id}/price-attribution",
+      "path": "/v1/events/{event_id}/price-attribution",
       "auth": true,
       "summary": "Get an event's price attribution",
       "credits": 1,
@@ -1757,7 +1757,7 @@
       "group": "events",
       "action": "prosody",
       "method": "get",
-      "path": "/v2/events/{event_id}/prosody",
+      "path": "/v1/events/{event_id}/prosody",
       "auth": true,
       "summary": "Get an event's speech prosody",
       "credits": 1,
@@ -1806,7 +1806,7 @@
       "group": "events",
       "action": "qa",
       "method": "get",
-      "path": "/v2/events/{event_id}/qa",
+      "path": "/v1/events/{event_id}/qa",
       "auth": true,
       "summary": "List an event's Q&A pairs",
       "credits": 1,
@@ -1884,7 +1884,7 @@
       "group": "events",
       "action": "slides",
       "method": "get",
-      "path": "/v2/events/{event_id}/slides",
+      "path": "/v1/events/{event_id}/slides",
       "auth": true,
       "summary": "Get an event's slides",
       "credits": 5,
@@ -1938,7 +1938,7 @@
       "group": "events",
       "action": "stats",
       "method": "get",
-      "path": "/v2/events/{event_id}/stats",
+      "path": "/v1/events/{event_id}/stats",
       "auth": true,
       "summary": "Get an event's call statistics",
       "credits": 1,
@@ -1982,7 +1982,7 @@
       "group": "events",
       "action": "transcript",
       "method": "get",
-      "path": "/v2/events/{event_id}/transcript",
+      "path": "/v1/events/{event_id}/transcript",
       "auth": true,
       "summary": "Get an event's transcript",
       "credits": 5,
@@ -2059,7 +2059,7 @@
       "group": "events",
       "action": "transcript-diff",
       "method": "get",
-      "path": "/v2/events/{event_id}/transcript-diff",
+      "path": "/v1/events/{event_id}/transcript-diff",
       "auth": true,
       "summary": "Diff two transcript versions",
       "credits": 5,
@@ -2115,7 +2115,7 @@
       "group": "events",
       "action": "transcript-text",
       "method": "get",
-      "path": "/v2/events/{event_id}/transcript-text",
+      "path": "/v1/events/{event_id}/transcript-text",
       "auth": true,
       "summary": "Get an event's transcript as text",
       "credits": 5,
@@ -2173,7 +2173,7 @@
       "group": "events",
       "action": "transcript-versions",
       "method": "get",
-      "path": "/v2/events/{event_id}/transcript-versions",
+      "path": "/v1/events/{event_id}/transcript-versions",
       "auth": true,
       "summary": "List an event's transcript versions",
       "credits": 1,
@@ -2234,7 +2234,7 @@
       "group": "filers",
       "action": "get",
       "method": "get",
-      "path": "/v2/filers/{cik}",
+      "path": "/v1/filers/{cik}",
       "auth": true,
       "summary": "Get a filer",
       "credits": 1,
@@ -2301,7 +2301,7 @@
       "group": "filers",
       "action": "list",
       "method": "get",
-      "path": "/v2/filers",
+      "path": "/v1/filers",
       "auth": true,
       "summary": "List SEC filers",
       "credits": 1,
@@ -2425,7 +2425,7 @@
       "group": "filings",
       "action": "datasets",
       "method": "get",
-      "path": "/v2/datasets",
+      "path": "/v1/datasets",
       "auth": true,
       "summary": "List SEC dataset releases",
       "credits": 1,
@@ -2479,7 +2479,7 @@
       "group": "filings",
       "action": "facts",
       "method": "get",
-      "path": "/v2/filings/{accession}/facts",
+      "path": "/v1/filings/{accession}/facts",
       "auth": true,
       "summary": "List a filing's numeric facts",
       "credits": 1,
@@ -2562,7 +2562,7 @@
       "group": "filings",
       "action": "get",
       "method": "get",
-      "path": "/v2/filings/{accession}",
+      "path": "/v1/filings/{accession}",
       "auth": true,
       "summary": "Get a filing",
       "credits": 1,
@@ -2627,7 +2627,7 @@
       "group": "filings",
       "action": "list",
       "method": "get",
-      "path": "/v2/filings",
+      "path": "/v1/filings",
       "auth": true,
       "summary": "List filings",
       "credits": 1,
@@ -2773,7 +2773,7 @@
       "group": "filings",
       "action": "notes",
       "method": "get",
-      "path": "/v2/filings/{accession}/notes",
+      "path": "/v1/filings/{accession}/notes",
       "auth": true,
       "summary": "List a filing's text facts",
       "credits": 1,
@@ -2850,7 +2850,7 @@
       "group": "filings",
       "action": "review-chain",
       "method": "get",
-      "path": "/v2/filings/{accession}/review-chain",
+      "path": "/v1/filings/{accession}/review-chain",
       "auth": true,
       "summary": "Get a filing's review chain",
       "credits": 1,
@@ -2930,7 +2930,7 @@
       "group": "financials",
       "action": "",
       "method": "get",
-      "path": "/v2/financials/as-reported",
+      "path": "/v1/financials/as-reported",
       "auth": true,
       "summary": "As-reported statements",
       "credits": 1,
@@ -3153,7 +3153,7 @@
       "group": "financials",
       "action": "",
       "method": "get",
-      "path": "/v2/financials/as-reported/detailed",
+      "path": "/v1/financials/as-reported/detailed",
       "auth": true,
       "summary": "As-reported statements with labels",
       "credits": 1,
@@ -3376,7 +3376,7 @@
       "group": "financials",
       "action": "",
       "method": "get",
-      "path": "/v2/financials/as-reported/presentation",
+      "path": "/v1/financials/as-reported/presentation",
       "auth": true,
       "summary": "As-reported statements as the filer's tree",
       "credits": 1,
@@ -3599,7 +3599,7 @@
       "group": "financials",
       "action": "",
       "method": "get",
-      "path": "/v2/financials/standardized",
+      "path": "/v1/financials/standardized",
       "auth": true,
       "summary": "Standardized statements",
       "credits": 1,
@@ -3798,7 +3798,7 @@
       "group": "financials",
       "action": "",
       "method": "get",
-      "path": "/v2/financials/standardized/detailed",
+      "path": "/v1/financials/standardized/detailed",
       "auth": true,
       "summary": "Standardized statements with lineage",
       "credits": 1,
@@ -3997,7 +3997,7 @@
       "group": "financials",
       "action": "",
       "method": "get",
-      "path": "/v2/financials/standardized/presentation",
+      "path": "/v1/financials/standardized/presentation",
       "auth": true,
       "summary": "Standardized statements as a tree",
       "credits": 1,
@@ -4196,7 +4196,7 @@
       "group": "guidance",
       "action": "kpis",
       "method": "get",
-      "path": "/v2/kpis",
+      "path": "/v1/kpis",
       "auth": true,
       "summary": "List KPI mentions",
       "credits": 1,
@@ -4314,7 +4314,7 @@
       "group": "guidance",
       "action": "list",
       "method": "get",
-      "path": "/v2/guidance",
+      "path": "/v1/guidance",
       "auth": true,
       "summary": "List guidance items",
       "credits": 1,
@@ -4473,7 +4473,7 @@
       "group": "holdings",
       "action": "changes",
       "method": "get",
-      "path": "/v2/holding-changes",
+      "path": "/v1/holding-changes",
       "auth": true,
       "summary": "List 13F position changes",
       "credits": 1,
@@ -4606,7 +4606,7 @@
       "group": "holdings",
       "action": "list",
       "method": "get",
-      "path": "/v2/holdings",
+      "path": "/v1/holdings",
       "auth": true,
       "summary": "List 13F holdings",
       "credits": 1,
@@ -4752,7 +4752,7 @@
       "group": "insider-trades",
       "action": "get",
       "method": "get",
-      "path": "/v2/insider-trades/{id}",
+      "path": "/v1/insider-trades/{id}",
       "auth": true,
       "summary": "Get an insider trade",
       "credits": 1,
@@ -4818,7 +4818,7 @@
       "group": "insider-trades",
       "action": "list",
       "method": "get",
-      "path": "/v2/insider-trades",
+      "path": "/v1/insider-trades",
       "auth": true,
       "summary": "List insider trades",
       "credits": 1,
@@ -4970,7 +4970,7 @@
       "group": "investor-documents",
       "action": "get",
       "method": "get",
-      "path": "/v2/investor-documents/{document_id}",
+      "path": "/v1/investor-documents/{document_id}",
       "auth": true,
       "summary": "Get an investor document",
       "credits": 1,
@@ -5047,7 +5047,7 @@
       "group": "investor-documents",
       "action": "list",
       "method": "get",
-      "path": "/v2/investor-documents",
+      "path": "/v1/investor-documents",
       "auth": true,
       "summary": "List investor documents",
       "credits": 1,
@@ -5201,7 +5201,7 @@
       "group": "ipos",
       "action": "get",
       "method": "get",
-      "path": "/v2/ipos/{ipo_id}",
+      "path": "/v1/ipos/{ipo_id}",
       "auth": true,
       "summary": "Get an offering",
       "credits": 1,
@@ -5260,7 +5260,7 @@
       "group": "ipos",
       "action": "list",
       "method": "get",
-      "path": "/v2/ipos",
+      "path": "/v1/ipos",
       "auth": true,
       "summary": "List offerings",
       "credits": 1,
@@ -5408,7 +5408,7 @@
       "group": "market",
       "action": "holidays",
       "method": "get",
-      "path": "/v2/market-holidays",
+      "path": "/v1/market-holidays",
       "auth": true,
       "summary": "List market holidays",
       "credits": 1,
@@ -5512,7 +5512,7 @@
       "group": "me",
       "action": "show",
       "method": "get",
-      "path": "/v2/me",
+      "path": "/v1/me",
       "auth": true,
       "summary": "Who am I",
       "credits": 0,
@@ -5536,7 +5536,7 @@
       "group": "me",
       "action": "usage",
       "method": "get",
-      "path": "/v2/me/usage",
+      "path": "/v1/me/usage",
       "auth": true,
       "summary": "Get my usage",
       "credits": 0,
@@ -5575,7 +5575,7 @@
       "group": "metrics",
       "action": "cagr",
       "method": "get",
-      "path": "/v2/metrics/cagr",
+      "path": "/v1/metrics/cagr",
       "auth": true,
       "summary": "List CAGRs",
       "credits": 1,
@@ -5731,7 +5731,7 @@
       "group": "metrics",
       "action": "explain",
       "method": "get",
-      "path": "/v2/facts/{fact_id}",
+      "path": "/v1/facts/{fact_id}",
       "auth": true,
       "summary": "Explain a standardized fact",
       "credits": 1,
@@ -5794,7 +5794,7 @@
       "group": "metrics",
       "action": "growth",
       "method": "get",
-      "path": "/v2/metrics/growth",
+      "path": "/v1/metrics/growth",
       "auth": true,
       "summary": "List growth rates",
       "credits": 1,
@@ -5951,7 +5951,7 @@
       "group": "metrics",
       "action": "ratios",
       "method": "get",
-      "path": "/v2/metrics/ratios",
+      "path": "/v1/metrics/ratios",
       "auth": true,
       "summary": "List ratios",
       "credits": 1,
@@ -6102,7 +6102,7 @@
       "group": "news",
       "action": "announcements",
       "method": "get",
-      "path": "/v2/announcements",
+      "path": "/v1/announcements",
       "auth": true,
       "summary": "List announcements",
       "credits": 2,
@@ -6275,7 +6275,7 @@
       "group": "news",
       "action": "get",
       "method": "get",
-      "path": "/v2/news/{id}",
+      "path": "/v1/news/{id}",
       "auth": true,
       "summary": "Get a news item",
       "credits": 2,
@@ -6341,7 +6341,7 @@
       "group": "news",
       "action": "list",
       "method": "get",
-      "path": "/v2/news",
+      "path": "/v1/news",
       "auth": true,
       "summary": "List news items",
       "credits": 1,
@@ -6511,7 +6511,7 @@
       "group": "news",
       "action": "text",
       "method": "get",
-      "path": "/v2/news/{id}/text",
+      "path": "/v1/news/{id}/text",
       "auth": true,
       "summary": "Get a news item's text",
       "credits": 2,
@@ -6571,7 +6571,7 @@
       "group": "people",
       "action": "get",
       "method": "get",
-      "path": "/v2/people/{person_id}",
+      "path": "/v1/people/{person_id}",
       "auth": true,
       "summary": "Get a person",
       "credits": 1,
@@ -6631,7 +6631,7 @@
       "group": "people",
       "action": "list",
       "method": "get",
-      "path": "/v2/people",
+      "path": "/v1/people",
       "auth": true,
       "summary": "List people",
       "credits": 1,
@@ -6768,7 +6768,7 @@
       "group": "people",
       "action": "participants",
       "method": "get",
-      "path": "/v2/participants",
+      "path": "/v1/participants",
       "auth": true,
       "summary": "List event participations",
       "credits": 1,
@@ -6869,7 +6869,7 @@
       "group": "search",
       "action": "filings",
       "method": "get",
-      "path": "/v2/search/filings",
+      "path": "/v1/search/filings",
       "auth": true,
       "summary": "Search filings",
       "credits": 100,
@@ -7028,7 +7028,7 @@
       "group": "search",
       "action": "investor-documents",
       "method": "get",
-      "path": "/v2/search/investor-documents",
+      "path": "/v1/search/investor-documents",
       "auth": true,
       "summary": "Search investor documents",
       "credits": 10,
@@ -7141,7 +7141,7 @@
       "group": "search",
       "action": "news",
       "method": "get",
-      "path": "/v2/search/news",
+      "path": "/v1/search/news",
       "auth": true,
       "summary": "Search news",
       "credits": 10,
@@ -7284,7 +7284,7 @@
       "group": "search",
       "action": "transcripts",
       "method": "get",
-      "path": "/v2/search/transcripts",
+      "path": "/v1/search/transcripts",
       "auth": true,
       "summary": "Search transcripts",
       "credits": 10,
@@ -7439,7 +7439,7 @@
       "group": "segments",
       "action": "list",
       "method": "get",
-      "path": "/v2/segments",
+      "path": "/v1/segments",
       "auth": true,
       "summary": "List segment values",
       "credits": 1,
@@ -7604,7 +7604,7 @@
       "group": "segments",
       "action": "list-detailed",
       "method": "get",
-      "path": "/v2/segments/detailed",
+      "path": "/v1/segments/detailed",
       "auth": true,
       "summary": "List segment values with lineage",
       "credits": 1,
@@ -7775,7 +7775,7 @@
       "group": "webhooks",
       "action": "create",
       "method": "post",
-      "path": "/v2/webhooks",
+      "path": "/v1/webhooks",
       "auth": true,
       "summary": "Create a webhook",
       "credits": 1,
@@ -7878,7 +7878,7 @@
       "group": "webhooks",
       "action": "delete",
       "method": "delete",
-      "path": "/v2/webhooks/{id}",
+      "path": "/v1/webhooks/{id}",
       "auth": true,
       "summary": "Delete a webhook",
       "credits": 1,
@@ -7907,7 +7907,7 @@
       "group": "webhooks",
       "action": "deliveries",
       "method": "get",
-      "path": "/v2/webhooks/{id}/deliveries",
+      "path": "/v1/webhooks/{id}/deliveries",
       "auth": true,
       "summary": "List a webhook's deliveries",
       "credits": 1,
@@ -7971,7 +7971,7 @@
       "group": "webhooks",
       "action": "get",
       "method": "get",
-      "path": "/v2/webhooks/{id}",
+      "path": "/v1/webhooks/{id}",
       "auth": true,
       "summary": "Get a webhook",
       "credits": 1,
@@ -8017,7 +8017,7 @@
       "group": "webhooks",
       "action": "list",
       "method": "get",
-      "path": "/v2/webhooks",
+      "path": "/v1/webhooks",
       "auth": true,
       "summary": "List webhooks",
       "credits": 1,
@@ -8069,7 +8069,7 @@
       "group": "webhooks",
       "action": "rotate-secret",
       "method": "post",
-      "path": "/v2/webhooks/{id}:rotate-secret",
+      "path": "/v1/webhooks/{id}:rotate-secret",
       "auth": true,
       "summary": "Rotate a webhook's secret",
       "credits": 1,
@@ -8105,7 +8105,7 @@
       "group": "webhooks",
       "action": "test",
       "method": "post",
-      "path": "/v2/webhooks/{id}:test",
+      "path": "/v1/webhooks/{id}:test",
       "auth": true,
       "summary": "Send a test delivery",
       "credits": 1,
@@ -8134,7 +8134,7 @@
       "group": "webhooks",
       "action": "update",
       "method": "patch",
-      "path": "/v2/webhooks/{id}",
+      "path": "/v1/webhooks/{id}",
       "auth": true,
       "summary": "Update a webhook",
       "credits": 1,

package/dist/src/spec-commands.js

@@ -149,7 +149,7 @@ function addPositionals(command, operation) {
     const description = param?.description ?? positional.name;
     if (positional.name === 'event_id') {
         command.argument('<event_id>', `${description}; or a company followed by a fiscal period (NVDA 2026Q3)`);
-        command.argument('[fiscal_period]', 'With a company in place of the event id: the fiscal period (2026Q3), resolved through GET /v2/events');
+        command.argument('[fiscal_period]', 'With a company in place of the event id: the fiscal period (2026Q3), resolved through GET /v1/events');
         return;
     }
     const name = positional.variadic ? `${positional.name}...` : positional.name;
@@ -248,7 +248,7 @@ async function planRequest(operation, positionals, opts, context) {
                 throw new UsageError(`${second} is not a fiscal period (expected e.g. 2026Q3)`);
             lookup = {
                 request: {
-                    path: '/v2/events',
+                    path: '/v1/events',
                     query: { company: String(first), fiscal_year: period.fiscalYear, fiscal_quarter: period.fiscalQuarter, limit: '1' },
                 },
                 company: String(first),
@@ -402,8 +402,8 @@ async function resolveLookup(plan) {
     const row = isRecord(body) && Array.isArray(body.data) ? body.data[0] : undefined;
     const eventId = isRecord(row) && typeof row.event_id === 'string' ? row.event_id : undefined;
     if (!eventId)
-        throw new Error(`No event for ${plan.lookup.company} ${plan.lookup.period} (GET /v2/events)`);
-    console.error(chalk.dim(`resolved ${plan.lookup.company} ${plan.lookup.period} → event ${eventId} (GET /v2/events, ${plan.lookup.credits} credit)`));
+        throw new Error(`No event for ${plan.lookup.company} ${plan.lookup.period} (GET /v1/events)`);
+    console.error(chalk.dim(`resolved ${plan.lookup.company} ${plan.lookup.period} → event ${eventId} (GET /v1/events, ${plan.lookup.credits} credit)`));
     return { request: { ...plan.request, path: plan.request.path.replace('{event_id}', encodeURIComponent(eventId)) } };
 }
 async function saveDownload(operation, body, file, force) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@invinite-org/invinite-data-cli",
-  "version": "4.0.0",
+  "version": "5.0.0",
   "type": "module",
   "description": "CLI for the Invinite Data API (v2)",
   "publishConfig": {