@invinite-org/data-api-client 5.1.0 → 5.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.openapi-generator/FILES +4 -0
- package/README.md +17 -0
- package/dist/esm/models/Event.d.ts +14 -0
- package/dist/esm/models/Event.js +6 -0
- package/dist/esm/models/EventPeriodicReport.d.ts +62 -0
- package/dist/esm/models/EventPeriodicReport.js +63 -0
- package/dist/esm/models/EventResultsFiling.d.ts +50 -0
- package/dist/esm/models/EventResultsFiling.js +55 -0
- package/dist/esm/models/index.d.ts +2 -0
- package/dist/esm/models/index.js +2 -0
- package/dist/models/Event.d.ts +14 -0
- package/dist/models/Event.js +6 -0
- package/dist/models/EventPeriodicReport.d.ts +62 -0
- package/dist/models/EventPeriodicReport.js +70 -0
- package/dist/models/EventResultsFiling.d.ts +50 -0
- package/dist/models/EventResultsFiling.js +62 -0
- package/dist/models/index.d.ts +2 -0
- package/dist/models/index.js +2 -0
- package/docs/Event.md +4 -0
- package/docs/EventPeriodicReport.md +45 -0
- package/docs/EventResultsFiling.md +41 -0
- package/package.json +1 -1
- package/src/models/Event.ts +30 -0
- package/src/models/EventPeriodicReport.ts +111 -0
- package/src/models/EventResultsFiling.ts +93 -0
- package/src/models/index.ts +2 -0
package/.openapi-generator/FILES
CHANGED
|
@@ -51,7 +51,9 @@ docs/EventComparisonNewTopicsInner.md
|
|
|
51
51
|
docs/EventComparisonPriorEvent.md
|
|
52
52
|
docs/EventComparisonSlideDiff.md
|
|
53
53
|
docs/EventObservationsInner.md
|
|
54
|
+
docs/EventPeriodicReport.md
|
|
54
55
|
docs/EventRef.md
|
|
56
|
+
docs/EventResultsFiling.md
|
|
55
57
|
docs/EventStats.md
|
|
56
58
|
docs/EventStatsEvent.md
|
|
57
59
|
docs/EventTypeCatalogEntry.md
|
|
@@ -326,7 +328,9 @@ src/models/EventComparisonNewTopicsInner.ts
|
|
|
326
328
|
src/models/EventComparisonPriorEvent.ts
|
|
327
329
|
src/models/EventComparisonSlideDiff.ts
|
|
328
330
|
src/models/EventObservationsInner.ts
|
|
331
|
+
src/models/EventPeriodicReport.ts
|
|
329
332
|
src/models/EventRef.ts
|
|
333
|
+
src/models/EventResultsFiling.ts
|
|
330
334
|
src/models/EventStats.ts
|
|
331
335
|
src/models/EventStatsEvent.ts
|
|
332
336
|
src/models/EventTypeCatalogEntry.ts
|
package/README.md
CHANGED
|
@@ -61,6 +61,23 @@ Every API class is named after a docs group (`CompaniesApi`, `FinancialsApi`, `F
|
|
|
61
61
|
(`listFilings`, `getCompany`). The company is always a filter: `company` takes a ticker
|
|
62
62
|
or a CIK, or a comma list of up to 50. Date parameters take a `Date`.
|
|
63
63
|
|
|
64
|
+
## An earnings event and its filings
|
|
65
|
+
|
|
66
|
+
Every event names its two SEC filings: `results_filing` (the earnings 8-K / 6-K) and
|
|
67
|
+
`periodic_report` (the 10-Q / 10-K of the event's fiscal period), each with
|
|
68
|
+
`edgar_index_url`; while unknown the API sends `null` and the client gives `undefined`:
|
|
69
|
+
|
|
70
|
+
```ts
|
|
71
|
+
import { Configuration, EventsApi } from "@invinite-org/data-api-client";
|
|
72
|
+
|
|
73
|
+
const api = new EventsApi(new Configuration({ accessToken: process.env.INVINITE_DATA_API_KEY }));
|
|
74
|
+
|
|
75
|
+
const page = await api.listEvents({ company: "AAPL", fiscalYear: 2026, fiscalQuarter: 4 });
|
|
76
|
+
const event = await api.getEvent({ eventId: page.data[0].event_id });
|
|
77
|
+
console.log(event.results_filing?.accession, event.results_filing?.form);
|
|
78
|
+
console.log(event.periodic_report?.form, event.periodic_report?.period_end, event.periodic_report?.edgar_index_url);
|
|
79
|
+
```
|
|
80
|
+
|
|
64
81
|
## Lists, cursors and the pager
|
|
65
82
|
|
|
66
83
|
Every list answers ONE envelope: `{ data, has_more, next_cursor, meta }`. Pass
|
|
@@ -9,6 +9,8 @@
|
|
|
9
9
|
* https://openapi-generator.tech
|
|
10
10
|
* Do not edit the class manually.
|
|
11
11
|
*/
|
|
12
|
+
import type { EventPeriodicReport } from './EventPeriodicReport';
|
|
13
|
+
import type { EventResultsFiling } from './EventResultsFiling';
|
|
12
14
|
import type { EventVideo } from './EventVideo';
|
|
13
15
|
import type { EventObservationsInner } from './EventObservationsInner';
|
|
14
16
|
import type { EventCalendar } from './EventCalendar';
|
|
@@ -192,6 +194,18 @@ export interface Event {
|
|
|
192
194
|
* @memberof Event
|
|
193
195
|
*/
|
|
194
196
|
video: EventVideo | null;
|
|
197
|
+
/**
|
|
198
|
+
*
|
|
199
|
+
* @type {EventResultsFiling}
|
|
200
|
+
* @memberof Event
|
|
201
|
+
*/
|
|
202
|
+
results_filing?: EventResultsFiling | null;
|
|
203
|
+
/**
|
|
204
|
+
*
|
|
205
|
+
* @type {EventPeriodicReport}
|
|
206
|
+
* @memberof Event
|
|
207
|
+
*/
|
|
208
|
+
periodic_report?: EventPeriodicReport | null;
|
|
195
209
|
/**
|
|
196
210
|
* Date / time observations, oldest first (at most 50)
|
|
197
211
|
* @type {Array<EventObservationsInner>}
|
package/dist/esm/models/Event.js
CHANGED
|
@@ -11,6 +11,8 @@
|
|
|
11
11
|
* https://openapi-generator.tech
|
|
12
12
|
* Do not edit the class manually.
|
|
13
13
|
*/
|
|
14
|
+
import { EventPeriodicReportFromJSON, EventPeriodicReportToJSON, } from './EventPeriodicReport';
|
|
15
|
+
import { EventResultsFilingFromJSON, EventResultsFilingToJSON, } from './EventResultsFiling';
|
|
14
16
|
import { EventVideoFromJSON, EventVideoToJSON, } from './EventVideo';
|
|
15
17
|
import { EventObservationsInnerFromJSON, EventObservationsInnerToJSON, } from './EventObservationsInner';
|
|
16
18
|
import { EventCalendarFromJSON, EventCalendarToJSON, } from './EventCalendar';
|
|
@@ -164,6 +166,8 @@ export function EventFromJSONTyped(json, ignoreDiscriminator) {
|
|
|
164
166
|
'has_documents': json['has_documents'],
|
|
165
167
|
'webcast_url': json['webcast_url'],
|
|
166
168
|
'video': EventVideoFromJSON(json['video']),
|
|
169
|
+
'results_filing': json['results_filing'] == null ? undefined : EventResultsFilingFromJSON(json['results_filing']),
|
|
170
|
+
'periodic_report': json['periodic_report'] == null ? undefined : EventPeriodicReportFromJSON(json['periodic_report']),
|
|
167
171
|
'observations': json['observations'] == null ? undefined : (json['observations'].map(EventObservationsInnerFromJSON)),
|
|
168
172
|
'calendar': json['calendar'] == null ? undefined : EventCalendarFromJSON(json['calendar']),
|
|
169
173
|
};
|
|
@@ -205,6 +209,8 @@ export function EventToJSONTyped(value, ignoreDiscriminator = false) {
|
|
|
205
209
|
'has_documents': value['has_documents'],
|
|
206
210
|
'webcast_url': value['webcast_url'],
|
|
207
211
|
'video': EventVideoToJSON(value['video']),
|
|
212
|
+
'results_filing': EventResultsFilingToJSON(value['results_filing']),
|
|
213
|
+
'periodic_report': EventPeriodicReportToJSON(value['periodic_report']),
|
|
208
214
|
'observations': value['observations'] == null ? undefined : (value['observations'].map(EventObservationsInnerToJSON)),
|
|
209
215
|
'calendar': EventCalendarToJSON(value['calendar']),
|
|
210
216
|
};
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Invinite API
|
|
3
|
+
* Invinite financial data API. Each operation has a base credit cost: `x-credits` is the base cost; responses add 1 credit per started 1,000 rows beyond the first 1,000; `X-Credits-Charged` reports the final debit and `X-Credits-Remaining` what is left of the plan\'s included credits after it. A `304 Not Modified` costs nothing. `GET /v1/me/usage` returns your account\'s usage by day, product family and key (it costs no credits). **Coverage.** 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. A known company with no data in a family (for example no statements yet) answers 404 with `code: not_covered`; an empty page of a covered company stays 200 with an empty list. `GET /v1/companies` lists every known company. ## Webhooks Accounts on LITE and above subscribe with `POST /v1/webhooks` to the `event.*` lifecycle events (filtered by company) and, on STANDARD and above, to `news.published` (one delivery per new news item, filtered by the companies it mentions); see `x-webhooks` for each `data` object. What a subscription may hold depends on the plan (a create / update beyond it is refused with the plan\'s limit; `event.test` needs no subscription — the test route and the disabled notice send it to any subscription): | Plan | Webhooks | Events | CIKs per webhook | Keywords per webhook | |---|---|---|---|---| | FREE | 0 | — | — | — | | LITE | 5 | `.scheduled`, `.rescheduled`, `.started`, `.ended`, `.transcript_ready`, `.assets_ready` | ≤ 10 | — | | STANDARD | 15 | LITE + `.transcript_provisional`, `.transcript_corrected`, `.documents_updated`, `news.published` | ≤ 25 | — | | PRO / ENTERPRISE | 50 | STANDARD + `.guidance_flash`, `.keyword_hit` | ≤ 100 | ≤ 20 (on ≤ 10 webhooks) | Every delivery is a `POST` with `Content-Type: application/json`, `X-Invinite-Event`, `X-Invinite-Delivery` and `X-Invinite-Signature: t=<unix seconds>,v1=<hex>` where `v1` = HMAC-SHA256(secret, `<t>.<raw body>`); during a secret rotation the header carries one `v1` per valid secret. Reject a signature older than 5 minutes. Any 2xx within 10 s acknowledges; redirects are not followed. A failed delivery is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 12 h, 24 h (8 attempts in all, the same delivery id each time). A subscription is disabled after 8 consecutive dead-lettered deliveries (a final `event.test` with `notice: subscription_disabled` is sent). Deliveries are at-least-once and unordered: dedupe on the delivery id, order by `created_at`. ## Licensing | Tier | display | redistribute | rag | train | audio | resell | | --- | --- | --- | --- | --- | --- | --- | | FREE | ✓ | – | – | – | – | – | | LITE | ✓ | – | – | – | – | – | | STANDARD | ✓ | – | ✓ | – | – | – | | PRO | ✓ | ✓ | ✓ | – | ✓ | – | Invinite data may be shown and, from PRO, redistributed inside the licensee\'s own product with attribution (\"Source: Invinite\" on screen or in the API response that carries it). It may never be resold, relicensed, white-labelled or offered as a data feed as the licensee\'s own data, at any tier, under any contract. Policy version: 2026-10-draft. Draft — pending counsel sign-off. Audio files carry a forensic watermark that identifies the recording. Audio is subject to per-company takedown and may not be re-hosted. SEC data: Figures and filings originate from SEC EDGAR; the standardisation, mapping and derived metrics are Invinite\'s. News: News text is Invinite\'s own summary of the issuer\'s or the SEC\'s publication (the publisher\'s text and media are never served); the licensee shows the attribution (publisher, source URL and date) next to it; the resale rule applies. PDF documents: Branded PDFs of transcripts and news items are permanent URLs to one shared file per version. They may be shown, downloaded and forwarded unmodified with the notice page intact; the resale rule applies unchanged. News PDFs carry Invinite\'s summary of the issuer\'s or the SEC\'s publication under the attribution stated on their notice page; a PDF disappears when the item is taken down or its source\'s reuse is denied. Every `/v1/_*` data operation carries `x-license`, the minimum use right its data ships with; `GET /status/licensing` serves the same matrix per route, rendered at [data.invinite.com/docs/licensing](https://data.invinite.com/docs/licensing). `/v1/me` and `/v1/me/usage` serve no licensed data and carry none. ## Status [`/status`](/status) reports whether each product family works (a status and its uptime over 7, 30 and 90 days); [`/status/licensing`](/status/licensing) serves the licensing matrix per route. The status routes need no API key and are cached for 5 minutes. The public status page is [status.data.invinite.com](https://status.data.invinite.com): a snapshot of `/status` every 15 minutes plus an external reachability probe of the API. Uptime is the share of requests answered without a server error, measured by the API per product family; a window with too little traffic to judge shows no figure. Status reflects the last 24 hours. Product families: Company, Financials, SEC Filings, Insider Trades, Institutional Ownership, IPOs, Market, Metadata, Earnings Calls, News, WebSocket, Account.
|
|
4
|
+
*
|
|
5
|
+
* The version of the OpenAPI document: 2026-11-11
|
|
6
|
+
*
|
|
7
|
+
*
|
|
8
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
9
|
+
* https://openapi-generator.tech
|
|
10
|
+
* Do not edit the class manually.
|
|
11
|
+
*/
|
|
12
|
+
/**
|
|
13
|
+
* The periodic report of the event's fiscal period: the 10-Q (10-QT) for a fiscal Q1–Q3, the 10-K (10-KT, 20-F, 40-F) for a fiscal Q4. null until it is filed and attributed; never an amendment. A foreign filer has none for Q1–Q3 (no quarterly form). Appended 2026-11
|
|
14
|
+
* @export
|
|
15
|
+
* @interface EventPeriodicReport
|
|
16
|
+
*/
|
|
17
|
+
export interface EventPeriodicReport {
|
|
18
|
+
/**
|
|
19
|
+
* SEC accession number (0000320193-26-000024)
|
|
20
|
+
* @type {string}
|
|
21
|
+
* @memberof EventPeriodicReport
|
|
22
|
+
*/
|
|
23
|
+
accession: string;
|
|
24
|
+
/**
|
|
25
|
+
* Form type (10-Q, 10-QT, 10-K, 10-KT, 20-F, 40-F)
|
|
26
|
+
* @type {string}
|
|
27
|
+
* @memberof EventPeriodicReport
|
|
28
|
+
*/
|
|
29
|
+
form: string;
|
|
30
|
+
/**
|
|
31
|
+
* Period end the filing reports (YYYY-MM-DD)
|
|
32
|
+
* @type {Date}
|
|
33
|
+
* @memberof EventPeriodicReport
|
|
34
|
+
*/
|
|
35
|
+
period_end: Date | null;
|
|
36
|
+
/**
|
|
37
|
+
* SEC filing date (YYYY-MM-DD)
|
|
38
|
+
* @type {Date}
|
|
39
|
+
* @memberof EventPeriodicReport
|
|
40
|
+
*/
|
|
41
|
+
filing_date: Date | null;
|
|
42
|
+
/**
|
|
43
|
+
* EDGAR acceptance time (ISO 8601 UTC)
|
|
44
|
+
* @type {Date}
|
|
45
|
+
* @memberof EventPeriodicReport
|
|
46
|
+
*/
|
|
47
|
+
accepted_at: Date | null;
|
|
48
|
+
/**
|
|
49
|
+
* The filing's EDGAR index page; null when the CIK is unknown
|
|
50
|
+
* @type {string}
|
|
51
|
+
* @memberof EventPeriodicReport
|
|
52
|
+
*/
|
|
53
|
+
edgar_index_url: string | null;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Check if a given object implements the EventPeriodicReport interface.
|
|
57
|
+
*/
|
|
58
|
+
export declare function instanceOfEventPeriodicReport(value: object): value is EventPeriodicReport;
|
|
59
|
+
export declare function EventPeriodicReportFromJSON(json: any): EventPeriodicReport;
|
|
60
|
+
export declare function EventPeriodicReportFromJSONTyped(json: any, ignoreDiscriminator: boolean): EventPeriodicReport;
|
|
61
|
+
export declare function EventPeriodicReportToJSON(json: any): EventPeriodicReport;
|
|
62
|
+
export declare function EventPeriodicReportToJSONTyped(value?: EventPeriodicReport | null, ignoreDiscriminator?: boolean): any;
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
/* tslint:disable */
|
|
2
|
+
/* eslint-disable */
|
|
3
|
+
/**
|
|
4
|
+
* Invinite API
|
|
5
|
+
* Invinite financial data API. Each operation has a base credit cost: `x-credits` is the base cost; responses add 1 credit per started 1,000 rows beyond the first 1,000; `X-Credits-Charged` reports the final debit and `X-Credits-Remaining` what is left of the plan\'s included credits after it. A `304 Not Modified` costs nothing. `GET /v1/me/usage` returns your account\'s usage by day, product family and key (it costs no credits). **Coverage.** 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. A known company with no data in a family (for example no statements yet) answers 404 with `code: not_covered`; an empty page of a covered company stays 200 with an empty list. `GET /v1/companies` lists every known company. ## Webhooks Accounts on LITE and above subscribe with `POST /v1/webhooks` to the `event.*` lifecycle events (filtered by company) and, on STANDARD and above, to `news.published` (one delivery per new news item, filtered by the companies it mentions); see `x-webhooks` for each `data` object. What a subscription may hold depends on the plan (a create / update beyond it is refused with the plan\'s limit; `event.test` needs no subscription — the test route and the disabled notice send it to any subscription): | Plan | Webhooks | Events | CIKs per webhook | Keywords per webhook | |---|---|---|---|---| | FREE | 0 | — | — | — | | LITE | 5 | `.scheduled`, `.rescheduled`, `.started`, `.ended`, `.transcript_ready`, `.assets_ready` | ≤ 10 | — | | STANDARD | 15 | LITE + `.transcript_provisional`, `.transcript_corrected`, `.documents_updated`, `news.published` | ≤ 25 | — | | PRO / ENTERPRISE | 50 | STANDARD + `.guidance_flash`, `.keyword_hit` | ≤ 100 | ≤ 20 (on ≤ 10 webhooks) | Every delivery is a `POST` with `Content-Type: application/json`, `X-Invinite-Event`, `X-Invinite-Delivery` and `X-Invinite-Signature: t=<unix seconds>,v1=<hex>` where `v1` = HMAC-SHA256(secret, `<t>.<raw body>`); during a secret rotation the header carries one `v1` per valid secret. Reject a signature older than 5 minutes. Any 2xx within 10 s acknowledges; redirects are not followed. A failed delivery is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 12 h, 24 h (8 attempts in all, the same delivery id each time). A subscription is disabled after 8 consecutive dead-lettered deliveries (a final `event.test` with `notice: subscription_disabled` is sent). Deliveries are at-least-once and unordered: dedupe on the delivery id, order by `created_at`. ## Licensing | Tier | display | redistribute | rag | train | audio | resell | | --- | --- | --- | --- | --- | --- | --- | | FREE | ✓ | – | – | – | – | – | | LITE | ✓ | – | – | – | – | – | | STANDARD | ✓ | – | ✓ | – | – | – | | PRO | ✓ | ✓ | ✓ | – | ✓ | – | Invinite data may be shown and, from PRO, redistributed inside the licensee\'s own product with attribution (\"Source: Invinite\" on screen or in the API response that carries it). It may never be resold, relicensed, white-labelled or offered as a data feed as the licensee\'s own data, at any tier, under any contract. Policy version: 2026-10-draft. Draft — pending counsel sign-off. Audio files carry a forensic watermark that identifies the recording. Audio is subject to per-company takedown and may not be re-hosted. SEC data: Figures and filings originate from SEC EDGAR; the standardisation, mapping and derived metrics are Invinite\'s. News: News text is Invinite\'s own summary of the issuer\'s or the SEC\'s publication (the publisher\'s text and media are never served); the licensee shows the attribution (publisher, source URL and date) next to it; the resale rule applies. PDF documents: Branded PDFs of transcripts and news items are permanent URLs to one shared file per version. They may be shown, downloaded and forwarded unmodified with the notice page intact; the resale rule applies unchanged. News PDFs carry Invinite\'s summary of the issuer\'s or the SEC\'s publication under the attribution stated on their notice page; a PDF disappears when the item is taken down or its source\'s reuse is denied. Every `/v1/_*` data operation carries `x-license`, the minimum use right its data ships with; `GET /status/licensing` serves the same matrix per route, rendered at [data.invinite.com/docs/licensing](https://data.invinite.com/docs/licensing). `/v1/me` and `/v1/me/usage` serve no licensed data and carry none. ## Status [`/status`](/status) reports whether each product family works (a status and its uptime over 7, 30 and 90 days); [`/status/licensing`](/status/licensing) serves the licensing matrix per route. The status routes need no API key and are cached for 5 minutes. The public status page is [status.data.invinite.com](https://status.data.invinite.com): a snapshot of `/status` every 15 minutes plus an external reachability probe of the API. Uptime is the share of requests answered without a server error, measured by the API per product family; a window with too little traffic to judge shows no figure. Status reflects the last 24 hours. Product families: Company, Financials, SEC Filings, Insider Trades, Institutional Ownership, IPOs, Market, Metadata, Earnings Calls, News, WebSocket, Account.
|
|
6
|
+
*
|
|
7
|
+
* The version of the OpenAPI document: 2026-11-11
|
|
8
|
+
*
|
|
9
|
+
*
|
|
10
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
11
|
+
* https://openapi-generator.tech
|
|
12
|
+
* Do not edit the class manually.
|
|
13
|
+
*/
|
|
14
|
+
/**
|
|
15
|
+
* Check if a given object implements the EventPeriodicReport interface.
|
|
16
|
+
*/
|
|
17
|
+
export function instanceOfEventPeriodicReport(value) {
|
|
18
|
+
if (!('accession' in value) || value['accession'] === undefined)
|
|
19
|
+
return false;
|
|
20
|
+
if (!('form' in value) || value['form'] === undefined)
|
|
21
|
+
return false;
|
|
22
|
+
if (!('period_end' in value) || value['period_end'] === undefined)
|
|
23
|
+
return false;
|
|
24
|
+
if (!('filing_date' in value) || value['filing_date'] === undefined)
|
|
25
|
+
return false;
|
|
26
|
+
if (!('accepted_at' in value) || value['accepted_at'] === undefined)
|
|
27
|
+
return false;
|
|
28
|
+
if (!('edgar_index_url' in value) || value['edgar_index_url'] === undefined)
|
|
29
|
+
return false;
|
|
30
|
+
return true;
|
|
31
|
+
}
|
|
32
|
+
export function EventPeriodicReportFromJSON(json) {
|
|
33
|
+
return EventPeriodicReportFromJSONTyped(json, false);
|
|
34
|
+
}
|
|
35
|
+
export function EventPeriodicReportFromJSONTyped(json, ignoreDiscriminator) {
|
|
36
|
+
if (json == null) {
|
|
37
|
+
return json;
|
|
38
|
+
}
|
|
39
|
+
return {
|
|
40
|
+
'accession': json['accession'],
|
|
41
|
+
'form': json['form'],
|
|
42
|
+
'period_end': (json['period_end'] == null ? null : new Date(json['period_end'])),
|
|
43
|
+
'filing_date': (json['filing_date'] == null ? null : new Date(json['filing_date'])),
|
|
44
|
+
'accepted_at': (json['accepted_at'] == null ? null : new Date(json['accepted_at'])),
|
|
45
|
+
'edgar_index_url': json['edgar_index_url'],
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
export function EventPeriodicReportToJSON(json) {
|
|
49
|
+
return EventPeriodicReportToJSONTyped(json, false);
|
|
50
|
+
}
|
|
51
|
+
export function EventPeriodicReportToJSONTyped(value, ignoreDiscriminator = false) {
|
|
52
|
+
if (value == null) {
|
|
53
|
+
return value;
|
|
54
|
+
}
|
|
55
|
+
return {
|
|
56
|
+
'accession': value['accession'],
|
|
57
|
+
'form': value['form'],
|
|
58
|
+
'period_end': value['period_end'] == null ? value['period_end'] : value['period_end'].toISOString().substring(0, 10),
|
|
59
|
+
'filing_date': value['filing_date'] == null ? value['filing_date'] : value['filing_date'].toISOString().substring(0, 10),
|
|
60
|
+
'accepted_at': value['accepted_at'] == null ? value['accepted_at'] : value['accepted_at'].toISOString(),
|
|
61
|
+
'edgar_index_url': value['edgar_index_url'],
|
|
62
|
+
};
|
|
63
|
+
}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Invinite API
|
|
3
|
+
* Invinite financial data API. Each operation has a base credit cost: `x-credits` is the base cost; responses add 1 credit per started 1,000 rows beyond the first 1,000; `X-Credits-Charged` reports the final debit and `X-Credits-Remaining` what is left of the plan\'s included credits after it. A `304 Not Modified` costs nothing. `GET /v1/me/usage` returns your account\'s usage by day, product family and key (it costs no credits). **Coverage.** 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. A known company with no data in a family (for example no statements yet) answers 404 with `code: not_covered`; an empty page of a covered company stays 200 with an empty list. `GET /v1/companies` lists every known company. ## Webhooks Accounts on LITE and above subscribe with `POST /v1/webhooks` to the `event.*` lifecycle events (filtered by company) and, on STANDARD and above, to `news.published` (one delivery per new news item, filtered by the companies it mentions); see `x-webhooks` for each `data` object. What a subscription may hold depends on the plan (a create / update beyond it is refused with the plan\'s limit; `event.test` needs no subscription — the test route and the disabled notice send it to any subscription): | Plan | Webhooks | Events | CIKs per webhook | Keywords per webhook | |---|---|---|---|---| | FREE | 0 | — | — | — | | LITE | 5 | `.scheduled`, `.rescheduled`, `.started`, `.ended`, `.transcript_ready`, `.assets_ready` | ≤ 10 | — | | STANDARD | 15 | LITE + `.transcript_provisional`, `.transcript_corrected`, `.documents_updated`, `news.published` | ≤ 25 | — | | PRO / ENTERPRISE | 50 | STANDARD + `.guidance_flash`, `.keyword_hit` | ≤ 100 | ≤ 20 (on ≤ 10 webhooks) | Every delivery is a `POST` with `Content-Type: application/json`, `X-Invinite-Event`, `X-Invinite-Delivery` and `X-Invinite-Signature: t=<unix seconds>,v1=<hex>` where `v1` = HMAC-SHA256(secret, `<t>.<raw body>`); during a secret rotation the header carries one `v1` per valid secret. Reject a signature older than 5 minutes. Any 2xx within 10 s acknowledges; redirects are not followed. A failed delivery is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 12 h, 24 h (8 attempts in all, the same delivery id each time). A subscription is disabled after 8 consecutive dead-lettered deliveries (a final `event.test` with `notice: subscription_disabled` is sent). Deliveries are at-least-once and unordered: dedupe on the delivery id, order by `created_at`. ## Licensing | Tier | display | redistribute | rag | train | audio | resell | | --- | --- | --- | --- | --- | --- | --- | | FREE | ✓ | – | – | – | – | – | | LITE | ✓ | – | – | – | – | – | | STANDARD | ✓ | – | ✓ | – | – | – | | PRO | ✓ | ✓ | ✓ | – | ✓ | – | Invinite data may be shown and, from PRO, redistributed inside the licensee\'s own product with attribution (\"Source: Invinite\" on screen or in the API response that carries it). It may never be resold, relicensed, white-labelled or offered as a data feed as the licensee\'s own data, at any tier, under any contract. Policy version: 2026-10-draft. Draft — pending counsel sign-off. Audio files carry a forensic watermark that identifies the recording. Audio is subject to per-company takedown and may not be re-hosted. SEC data: Figures and filings originate from SEC EDGAR; the standardisation, mapping and derived metrics are Invinite\'s. News: News text is Invinite\'s own summary of the issuer\'s or the SEC\'s publication (the publisher\'s text and media are never served); the licensee shows the attribution (publisher, source URL and date) next to it; the resale rule applies. PDF documents: Branded PDFs of transcripts and news items are permanent URLs to one shared file per version. They may be shown, downloaded and forwarded unmodified with the notice page intact; the resale rule applies unchanged. News PDFs carry Invinite\'s summary of the issuer\'s or the SEC\'s publication under the attribution stated on their notice page; a PDF disappears when the item is taken down or its source\'s reuse is denied. Every `/v1/_*` data operation carries `x-license`, the minimum use right its data ships with; `GET /status/licensing` serves the same matrix per route, rendered at [data.invinite.com/docs/licensing](https://data.invinite.com/docs/licensing). `/v1/me` and `/v1/me/usage` serve no licensed data and carry none. ## Status [`/status`](/status) reports whether each product family works (a status and its uptime over 7, 30 and 90 days); [`/status/licensing`](/status/licensing) serves the licensing matrix per route. The status routes need no API key and are cached for 5 minutes. The public status page is [status.data.invinite.com](https://status.data.invinite.com): a snapshot of `/status` every 15 minutes plus an external reachability probe of the API. Uptime is the share of requests answered without a server error, measured by the API per product family; a window with too little traffic to judge shows no figure. Status reflects the last 24 hours. Product families: Company, Financials, SEC Filings, Insider Trades, Institutional Ownership, IPOs, Market, Metadata, Earnings Calls, News, WebSocket, Account.
|
|
4
|
+
*
|
|
5
|
+
* The version of the OpenAPI document: 2026-11-11
|
|
6
|
+
*
|
|
7
|
+
*
|
|
8
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
9
|
+
* https://openapi-generator.tech
|
|
10
|
+
* Do not edit the class manually.
|
|
11
|
+
*/
|
|
12
|
+
/**
|
|
13
|
+
* The results filing: the earnings 8-K / 6-K (or its first attributed filing) whose EDGAR acceptance stamped `results_released_at`. Read the document with the SEC filing operations by `accession`. null before the results are filed. Appended 2026-11
|
|
14
|
+
* @export
|
|
15
|
+
* @interface EventResultsFiling
|
|
16
|
+
*/
|
|
17
|
+
export interface EventResultsFiling {
|
|
18
|
+
/**
|
|
19
|
+
* SEC accession number (0000320193-26-000024)
|
|
20
|
+
* @type {string}
|
|
21
|
+
* @memberof EventResultsFiling
|
|
22
|
+
*/
|
|
23
|
+
accession: string;
|
|
24
|
+
/**
|
|
25
|
+
* Form type (8-K, 8-K/A, 6-K, 6-K/A)
|
|
26
|
+
* @type {string}
|
|
27
|
+
* @memberof EventResultsFiling
|
|
28
|
+
*/
|
|
29
|
+
form: string;
|
|
30
|
+
/**
|
|
31
|
+
* EDGAR acceptance time (ISO 8601 UTC)
|
|
32
|
+
* @type {Date}
|
|
33
|
+
* @memberof EventResultsFiling
|
|
34
|
+
*/
|
|
35
|
+
accepted_at: Date | null;
|
|
36
|
+
/**
|
|
37
|
+
* The filing's EDGAR index page; null when the CIK is unknown
|
|
38
|
+
* @type {string}
|
|
39
|
+
* @memberof EventResultsFiling
|
|
40
|
+
*/
|
|
41
|
+
edgar_index_url: string | null;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Check if a given object implements the EventResultsFiling interface.
|
|
45
|
+
*/
|
|
46
|
+
export declare function instanceOfEventResultsFiling(value: object): value is EventResultsFiling;
|
|
47
|
+
export declare function EventResultsFilingFromJSON(json: any): EventResultsFiling;
|
|
48
|
+
export declare function EventResultsFilingFromJSONTyped(json: any, ignoreDiscriminator: boolean): EventResultsFiling;
|
|
49
|
+
export declare function EventResultsFilingToJSON(json: any): EventResultsFiling;
|
|
50
|
+
export declare function EventResultsFilingToJSONTyped(value?: EventResultsFiling | null, ignoreDiscriminator?: boolean): any;
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
/* tslint:disable */
|
|
2
|
+
/* eslint-disable */
|
|
3
|
+
/**
|
|
4
|
+
* Invinite API
|
|
5
|
+
* Invinite financial data API. Each operation has a base credit cost: `x-credits` is the base cost; responses add 1 credit per started 1,000 rows beyond the first 1,000; `X-Credits-Charged` reports the final debit and `X-Credits-Remaining` what is left of the plan\'s included credits after it. A `304 Not Modified` costs nothing. `GET /v1/me/usage` returns your account\'s usage by day, product family and key (it costs no credits). **Coverage.** 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. A known company with no data in a family (for example no statements yet) answers 404 with `code: not_covered`; an empty page of a covered company stays 200 with an empty list. `GET /v1/companies` lists every known company. ## Webhooks Accounts on LITE and above subscribe with `POST /v1/webhooks` to the `event.*` lifecycle events (filtered by company) and, on STANDARD and above, to `news.published` (one delivery per new news item, filtered by the companies it mentions); see `x-webhooks` for each `data` object. What a subscription may hold depends on the plan (a create / update beyond it is refused with the plan\'s limit; `event.test` needs no subscription — the test route and the disabled notice send it to any subscription): | Plan | Webhooks | Events | CIKs per webhook | Keywords per webhook | |---|---|---|---|---| | FREE | 0 | — | — | — | | LITE | 5 | `.scheduled`, `.rescheduled`, `.started`, `.ended`, `.transcript_ready`, `.assets_ready` | ≤ 10 | — | | STANDARD | 15 | LITE + `.transcript_provisional`, `.transcript_corrected`, `.documents_updated`, `news.published` | ≤ 25 | — | | PRO / ENTERPRISE | 50 | STANDARD + `.guidance_flash`, `.keyword_hit` | ≤ 100 | ≤ 20 (on ≤ 10 webhooks) | Every delivery is a `POST` with `Content-Type: application/json`, `X-Invinite-Event`, `X-Invinite-Delivery` and `X-Invinite-Signature: t=<unix seconds>,v1=<hex>` where `v1` = HMAC-SHA256(secret, `<t>.<raw body>`); during a secret rotation the header carries one `v1` per valid secret. Reject a signature older than 5 minutes. Any 2xx within 10 s acknowledges; redirects are not followed. A failed delivery is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 12 h, 24 h (8 attempts in all, the same delivery id each time). A subscription is disabled after 8 consecutive dead-lettered deliveries (a final `event.test` with `notice: subscription_disabled` is sent). Deliveries are at-least-once and unordered: dedupe on the delivery id, order by `created_at`. ## Licensing | Tier | display | redistribute | rag | train | audio | resell | | --- | --- | --- | --- | --- | --- | --- | | FREE | ✓ | – | – | – | – | – | | LITE | ✓ | – | – | – | – | – | | STANDARD | ✓ | – | ✓ | – | – | – | | PRO | ✓ | ✓ | ✓ | – | ✓ | – | Invinite data may be shown and, from PRO, redistributed inside the licensee\'s own product with attribution (\"Source: Invinite\" on screen or in the API response that carries it). It may never be resold, relicensed, white-labelled or offered as a data feed as the licensee\'s own data, at any tier, under any contract. Policy version: 2026-10-draft. Draft — pending counsel sign-off. Audio files carry a forensic watermark that identifies the recording. Audio is subject to per-company takedown and may not be re-hosted. SEC data: Figures and filings originate from SEC EDGAR; the standardisation, mapping and derived metrics are Invinite\'s. News: News text is Invinite\'s own summary of the issuer\'s or the SEC\'s publication (the publisher\'s text and media are never served); the licensee shows the attribution (publisher, source URL and date) next to it; the resale rule applies. PDF documents: Branded PDFs of transcripts and news items are permanent URLs to one shared file per version. They may be shown, downloaded and forwarded unmodified with the notice page intact; the resale rule applies unchanged. News PDFs carry Invinite\'s summary of the issuer\'s or the SEC\'s publication under the attribution stated on their notice page; a PDF disappears when the item is taken down or its source\'s reuse is denied. Every `/v1/_*` data operation carries `x-license`, the minimum use right its data ships with; `GET /status/licensing` serves the same matrix per route, rendered at [data.invinite.com/docs/licensing](https://data.invinite.com/docs/licensing). `/v1/me` and `/v1/me/usage` serve no licensed data and carry none. ## Status [`/status`](/status) reports whether each product family works (a status and its uptime over 7, 30 and 90 days); [`/status/licensing`](/status/licensing) serves the licensing matrix per route. The status routes need no API key and are cached for 5 minutes. The public status page is [status.data.invinite.com](https://status.data.invinite.com): a snapshot of `/status` every 15 minutes plus an external reachability probe of the API. Uptime is the share of requests answered without a server error, measured by the API per product family; a window with too little traffic to judge shows no figure. Status reflects the last 24 hours. Product families: Company, Financials, SEC Filings, Insider Trades, Institutional Ownership, IPOs, Market, Metadata, Earnings Calls, News, WebSocket, Account.
|
|
6
|
+
*
|
|
7
|
+
* The version of the OpenAPI document: 2026-11-11
|
|
8
|
+
*
|
|
9
|
+
*
|
|
10
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
11
|
+
* https://openapi-generator.tech
|
|
12
|
+
* Do not edit the class manually.
|
|
13
|
+
*/
|
|
14
|
+
/**
|
|
15
|
+
* Check if a given object implements the EventResultsFiling interface.
|
|
16
|
+
*/
|
|
17
|
+
export function instanceOfEventResultsFiling(value) {
|
|
18
|
+
if (!('accession' in value) || value['accession'] === undefined)
|
|
19
|
+
return false;
|
|
20
|
+
if (!('form' in value) || value['form'] === undefined)
|
|
21
|
+
return false;
|
|
22
|
+
if (!('accepted_at' in value) || value['accepted_at'] === undefined)
|
|
23
|
+
return false;
|
|
24
|
+
if (!('edgar_index_url' in value) || value['edgar_index_url'] === undefined)
|
|
25
|
+
return false;
|
|
26
|
+
return true;
|
|
27
|
+
}
|
|
28
|
+
export function EventResultsFilingFromJSON(json) {
|
|
29
|
+
return EventResultsFilingFromJSONTyped(json, false);
|
|
30
|
+
}
|
|
31
|
+
export function EventResultsFilingFromJSONTyped(json, ignoreDiscriminator) {
|
|
32
|
+
if (json == null) {
|
|
33
|
+
return json;
|
|
34
|
+
}
|
|
35
|
+
return {
|
|
36
|
+
'accession': json['accession'],
|
|
37
|
+
'form': json['form'],
|
|
38
|
+
'accepted_at': (json['accepted_at'] == null ? null : new Date(json['accepted_at'])),
|
|
39
|
+
'edgar_index_url': json['edgar_index_url'],
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
export function EventResultsFilingToJSON(json) {
|
|
43
|
+
return EventResultsFilingToJSONTyped(json, false);
|
|
44
|
+
}
|
|
45
|
+
export function EventResultsFilingToJSONTyped(value, ignoreDiscriminator = false) {
|
|
46
|
+
if (value == null) {
|
|
47
|
+
return value;
|
|
48
|
+
}
|
|
49
|
+
return {
|
|
50
|
+
'accession': value['accession'],
|
|
51
|
+
'form': value['form'],
|
|
52
|
+
'accepted_at': value['accepted_at'] == null ? value['accepted_at'] : value['accepted_at'].toISOString(),
|
|
53
|
+
'edgar_index_url': value['edgar_index_url'],
|
|
54
|
+
};
|
|
55
|
+
}
|
|
@@ -42,7 +42,9 @@ export * from './EventComparisonNewTopicsInner';
|
|
|
42
42
|
export * from './EventComparisonPriorEvent';
|
|
43
43
|
export * from './EventComparisonSlideDiff';
|
|
44
44
|
export * from './EventObservationsInner';
|
|
45
|
+
export * from './EventPeriodicReport';
|
|
45
46
|
export * from './EventRef';
|
|
47
|
+
export * from './EventResultsFiling';
|
|
46
48
|
export * from './EventStats';
|
|
47
49
|
export * from './EventStatsEvent';
|
|
48
50
|
export * from './EventTypeCatalogEntry';
|
package/dist/esm/models/index.js
CHANGED
|
@@ -44,7 +44,9 @@ export * from './EventComparisonNewTopicsInner';
|
|
|
44
44
|
export * from './EventComparisonPriorEvent';
|
|
45
45
|
export * from './EventComparisonSlideDiff';
|
|
46
46
|
export * from './EventObservationsInner';
|
|
47
|
+
export * from './EventPeriodicReport';
|
|
47
48
|
export * from './EventRef';
|
|
49
|
+
export * from './EventResultsFiling';
|
|
48
50
|
export * from './EventStats';
|
|
49
51
|
export * from './EventStatsEvent';
|
|
50
52
|
export * from './EventTypeCatalogEntry';
|
package/dist/models/Event.d.ts
CHANGED
|
@@ -9,6 +9,8 @@
|
|
|
9
9
|
* https://openapi-generator.tech
|
|
10
10
|
* Do not edit the class manually.
|
|
11
11
|
*/
|
|
12
|
+
import type { EventPeriodicReport } from './EventPeriodicReport';
|
|
13
|
+
import type { EventResultsFiling } from './EventResultsFiling';
|
|
12
14
|
import type { EventVideo } from './EventVideo';
|
|
13
15
|
import type { EventObservationsInner } from './EventObservationsInner';
|
|
14
16
|
import type { EventCalendar } from './EventCalendar';
|
|
@@ -192,6 +194,18 @@ export interface Event {
|
|
|
192
194
|
* @memberof Event
|
|
193
195
|
*/
|
|
194
196
|
video: EventVideo | null;
|
|
197
|
+
/**
|
|
198
|
+
*
|
|
199
|
+
* @type {EventResultsFiling}
|
|
200
|
+
* @memberof Event
|
|
201
|
+
*/
|
|
202
|
+
results_filing?: EventResultsFiling | null;
|
|
203
|
+
/**
|
|
204
|
+
*
|
|
205
|
+
* @type {EventPeriodicReport}
|
|
206
|
+
* @memberof Event
|
|
207
|
+
*/
|
|
208
|
+
periodic_report?: EventPeriodicReport | null;
|
|
195
209
|
/**
|
|
196
210
|
* Date / time observations, oldest first (at most 50)
|
|
197
211
|
* @type {Array<EventObservationsInner>}
|
package/dist/models/Event.js
CHANGED
|
@@ -19,6 +19,8 @@ exports.EventFromJSON = EventFromJSON;
|
|
|
19
19
|
exports.EventFromJSONTyped = EventFromJSONTyped;
|
|
20
20
|
exports.EventToJSON = EventToJSON;
|
|
21
21
|
exports.EventToJSONTyped = EventToJSONTyped;
|
|
22
|
+
const EventPeriodicReport_1 = require("./EventPeriodicReport");
|
|
23
|
+
const EventResultsFiling_1 = require("./EventResultsFiling");
|
|
22
24
|
const EventVideo_1 = require("./EventVideo");
|
|
23
25
|
const EventObservationsInner_1 = require("./EventObservationsInner");
|
|
24
26
|
const EventCalendar_1 = require("./EventCalendar");
|
|
@@ -172,6 +174,8 @@ function EventFromJSONTyped(json, ignoreDiscriminator) {
|
|
|
172
174
|
'has_documents': json['has_documents'],
|
|
173
175
|
'webcast_url': json['webcast_url'],
|
|
174
176
|
'video': (0, EventVideo_1.EventVideoFromJSON)(json['video']),
|
|
177
|
+
'results_filing': json['results_filing'] == null ? undefined : (0, EventResultsFiling_1.EventResultsFilingFromJSON)(json['results_filing']),
|
|
178
|
+
'periodic_report': json['periodic_report'] == null ? undefined : (0, EventPeriodicReport_1.EventPeriodicReportFromJSON)(json['periodic_report']),
|
|
175
179
|
'observations': json['observations'] == null ? undefined : (json['observations'].map(EventObservationsInner_1.EventObservationsInnerFromJSON)),
|
|
176
180
|
'calendar': json['calendar'] == null ? undefined : (0, EventCalendar_1.EventCalendarFromJSON)(json['calendar']),
|
|
177
181
|
};
|
|
@@ -213,6 +217,8 @@ function EventToJSONTyped(value, ignoreDiscriminator = false) {
|
|
|
213
217
|
'has_documents': value['has_documents'],
|
|
214
218
|
'webcast_url': value['webcast_url'],
|
|
215
219
|
'video': (0, EventVideo_1.EventVideoToJSON)(value['video']),
|
|
220
|
+
'results_filing': (0, EventResultsFiling_1.EventResultsFilingToJSON)(value['results_filing']),
|
|
221
|
+
'periodic_report': (0, EventPeriodicReport_1.EventPeriodicReportToJSON)(value['periodic_report']),
|
|
216
222
|
'observations': value['observations'] == null ? undefined : (value['observations'].map(EventObservationsInner_1.EventObservationsInnerToJSON)),
|
|
217
223
|
'calendar': (0, EventCalendar_1.EventCalendarToJSON)(value['calendar']),
|
|
218
224
|
};
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Invinite API
|
|
3
|
+
* Invinite financial data API. Each operation has a base credit cost: `x-credits` is the base cost; responses add 1 credit per started 1,000 rows beyond the first 1,000; `X-Credits-Charged` reports the final debit and `X-Credits-Remaining` what is left of the plan\'s included credits after it. A `304 Not Modified` costs nothing. `GET /v1/me/usage` returns your account\'s usage by day, product family and key (it costs no credits). **Coverage.** 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. A known company with no data in a family (for example no statements yet) answers 404 with `code: not_covered`; an empty page of a covered company stays 200 with an empty list. `GET /v1/companies` lists every known company. ## Webhooks Accounts on LITE and above subscribe with `POST /v1/webhooks` to the `event.*` lifecycle events (filtered by company) and, on STANDARD and above, to `news.published` (one delivery per new news item, filtered by the companies it mentions); see `x-webhooks` for each `data` object. What a subscription may hold depends on the plan (a create / update beyond it is refused with the plan\'s limit; `event.test` needs no subscription — the test route and the disabled notice send it to any subscription): | Plan | Webhooks | Events | CIKs per webhook | Keywords per webhook | |---|---|---|---|---| | FREE | 0 | — | — | — | | LITE | 5 | `.scheduled`, `.rescheduled`, `.started`, `.ended`, `.transcript_ready`, `.assets_ready` | ≤ 10 | — | | STANDARD | 15 | LITE + `.transcript_provisional`, `.transcript_corrected`, `.documents_updated`, `news.published` | ≤ 25 | — | | PRO / ENTERPRISE | 50 | STANDARD + `.guidance_flash`, `.keyword_hit` | ≤ 100 | ≤ 20 (on ≤ 10 webhooks) | Every delivery is a `POST` with `Content-Type: application/json`, `X-Invinite-Event`, `X-Invinite-Delivery` and `X-Invinite-Signature: t=<unix seconds>,v1=<hex>` where `v1` = HMAC-SHA256(secret, `<t>.<raw body>`); during a secret rotation the header carries one `v1` per valid secret. Reject a signature older than 5 minutes. Any 2xx within 10 s acknowledges; redirects are not followed. A failed delivery is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 12 h, 24 h (8 attempts in all, the same delivery id each time). A subscription is disabled after 8 consecutive dead-lettered deliveries (a final `event.test` with `notice: subscription_disabled` is sent). Deliveries are at-least-once and unordered: dedupe on the delivery id, order by `created_at`. ## Licensing | Tier | display | redistribute | rag | train | audio | resell | | --- | --- | --- | --- | --- | --- | --- | | FREE | ✓ | – | – | – | – | – | | LITE | ✓ | – | – | – | – | – | | STANDARD | ✓ | – | ✓ | – | – | – | | PRO | ✓ | ✓ | ✓ | – | ✓ | – | Invinite data may be shown and, from PRO, redistributed inside the licensee\'s own product with attribution (\"Source: Invinite\" on screen or in the API response that carries it). It may never be resold, relicensed, white-labelled or offered as a data feed as the licensee\'s own data, at any tier, under any contract. Policy version: 2026-10-draft. Draft — pending counsel sign-off. Audio files carry a forensic watermark that identifies the recording. Audio is subject to per-company takedown and may not be re-hosted. SEC data: Figures and filings originate from SEC EDGAR; the standardisation, mapping and derived metrics are Invinite\'s. News: News text is Invinite\'s own summary of the issuer\'s or the SEC\'s publication (the publisher\'s text and media are never served); the licensee shows the attribution (publisher, source URL and date) next to it; the resale rule applies. PDF documents: Branded PDFs of transcripts and news items are permanent URLs to one shared file per version. They may be shown, downloaded and forwarded unmodified with the notice page intact; the resale rule applies unchanged. News PDFs carry Invinite\'s summary of the issuer\'s or the SEC\'s publication under the attribution stated on their notice page; a PDF disappears when the item is taken down or its source\'s reuse is denied. Every `/v1/_*` data operation carries `x-license`, the minimum use right its data ships with; `GET /status/licensing` serves the same matrix per route, rendered at [data.invinite.com/docs/licensing](https://data.invinite.com/docs/licensing). `/v1/me` and `/v1/me/usage` serve no licensed data and carry none. ## Status [`/status`](/status) reports whether each product family works (a status and its uptime over 7, 30 and 90 days); [`/status/licensing`](/status/licensing) serves the licensing matrix per route. The status routes need no API key and are cached for 5 minutes. The public status page is [status.data.invinite.com](https://status.data.invinite.com): a snapshot of `/status` every 15 minutes plus an external reachability probe of the API. Uptime is the share of requests answered without a server error, measured by the API per product family; a window with too little traffic to judge shows no figure. Status reflects the last 24 hours. Product families: Company, Financials, SEC Filings, Insider Trades, Institutional Ownership, IPOs, Market, Metadata, Earnings Calls, News, WebSocket, Account.
|
|
4
|
+
*
|
|
5
|
+
* The version of the OpenAPI document: 2026-11-11
|
|
6
|
+
*
|
|
7
|
+
*
|
|
8
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
9
|
+
* https://openapi-generator.tech
|
|
10
|
+
* Do not edit the class manually.
|
|
11
|
+
*/
|
|
12
|
+
/**
|
|
13
|
+
* The periodic report of the event's fiscal period: the 10-Q (10-QT) for a fiscal Q1–Q3, the 10-K (10-KT, 20-F, 40-F) for a fiscal Q4. null until it is filed and attributed; never an amendment. A foreign filer has none for Q1–Q3 (no quarterly form). Appended 2026-11
|
|
14
|
+
* @export
|
|
15
|
+
* @interface EventPeriodicReport
|
|
16
|
+
*/
|
|
17
|
+
export interface EventPeriodicReport {
|
|
18
|
+
/**
|
|
19
|
+
* SEC accession number (0000320193-26-000024)
|
|
20
|
+
* @type {string}
|
|
21
|
+
* @memberof EventPeriodicReport
|
|
22
|
+
*/
|
|
23
|
+
accession: string;
|
|
24
|
+
/**
|
|
25
|
+
* Form type (10-Q, 10-QT, 10-K, 10-KT, 20-F, 40-F)
|
|
26
|
+
* @type {string}
|
|
27
|
+
* @memberof EventPeriodicReport
|
|
28
|
+
*/
|
|
29
|
+
form: string;
|
|
30
|
+
/**
|
|
31
|
+
* Period end the filing reports (YYYY-MM-DD)
|
|
32
|
+
* @type {Date}
|
|
33
|
+
* @memberof EventPeriodicReport
|
|
34
|
+
*/
|
|
35
|
+
period_end: Date | null;
|
|
36
|
+
/**
|
|
37
|
+
* SEC filing date (YYYY-MM-DD)
|
|
38
|
+
* @type {Date}
|
|
39
|
+
* @memberof EventPeriodicReport
|
|
40
|
+
*/
|
|
41
|
+
filing_date: Date | null;
|
|
42
|
+
/**
|
|
43
|
+
* EDGAR acceptance time (ISO 8601 UTC)
|
|
44
|
+
* @type {Date}
|
|
45
|
+
* @memberof EventPeriodicReport
|
|
46
|
+
*/
|
|
47
|
+
accepted_at: Date | null;
|
|
48
|
+
/**
|
|
49
|
+
* The filing's EDGAR index page; null when the CIK is unknown
|
|
50
|
+
* @type {string}
|
|
51
|
+
* @memberof EventPeriodicReport
|
|
52
|
+
*/
|
|
53
|
+
edgar_index_url: string | null;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Check if a given object implements the EventPeriodicReport interface.
|
|
57
|
+
*/
|
|
58
|
+
export declare function instanceOfEventPeriodicReport(value: object): value is EventPeriodicReport;
|
|
59
|
+
export declare function EventPeriodicReportFromJSON(json: any): EventPeriodicReport;
|
|
60
|
+
export declare function EventPeriodicReportFromJSONTyped(json: any, ignoreDiscriminator: boolean): EventPeriodicReport;
|
|
61
|
+
export declare function EventPeriodicReportToJSON(json: any): EventPeriodicReport;
|
|
62
|
+
export declare function EventPeriodicReportToJSONTyped(value?: EventPeriodicReport | null, ignoreDiscriminator?: boolean): any;
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/* tslint:disable */
|
|
3
|
+
/* eslint-disable */
|
|
4
|
+
/**
|
|
5
|
+
* Invinite API
|
|
6
|
+
* Invinite financial data API. Each operation has a base credit cost: `x-credits` is the base cost; responses add 1 credit per started 1,000 rows beyond the first 1,000; `X-Credits-Charged` reports the final debit and `X-Credits-Remaining` what is left of the plan\'s included credits after it. A `304 Not Modified` costs nothing. `GET /v1/me/usage` returns your account\'s usage by day, product family and key (it costs no credits). **Coverage.** 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. A known company with no data in a family (for example no statements yet) answers 404 with `code: not_covered`; an empty page of a covered company stays 200 with an empty list. `GET /v1/companies` lists every known company. ## Webhooks Accounts on LITE and above subscribe with `POST /v1/webhooks` to the `event.*` lifecycle events (filtered by company) and, on STANDARD and above, to `news.published` (one delivery per new news item, filtered by the companies it mentions); see `x-webhooks` for each `data` object. What a subscription may hold depends on the plan (a create / update beyond it is refused with the plan\'s limit; `event.test` needs no subscription — the test route and the disabled notice send it to any subscription): | Plan | Webhooks | Events | CIKs per webhook | Keywords per webhook | |---|---|---|---|---| | FREE | 0 | — | — | — | | LITE | 5 | `.scheduled`, `.rescheduled`, `.started`, `.ended`, `.transcript_ready`, `.assets_ready` | ≤ 10 | — | | STANDARD | 15 | LITE + `.transcript_provisional`, `.transcript_corrected`, `.documents_updated`, `news.published` | ≤ 25 | — | | PRO / ENTERPRISE | 50 | STANDARD + `.guidance_flash`, `.keyword_hit` | ≤ 100 | ≤ 20 (on ≤ 10 webhooks) | Every delivery is a `POST` with `Content-Type: application/json`, `X-Invinite-Event`, `X-Invinite-Delivery` and `X-Invinite-Signature: t=<unix seconds>,v1=<hex>` where `v1` = HMAC-SHA256(secret, `<t>.<raw body>`); during a secret rotation the header carries one `v1` per valid secret. Reject a signature older than 5 minutes. Any 2xx within 10 s acknowledges; redirects are not followed. A failed delivery is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 12 h, 24 h (8 attempts in all, the same delivery id each time). A subscription is disabled after 8 consecutive dead-lettered deliveries (a final `event.test` with `notice: subscription_disabled` is sent). Deliveries are at-least-once and unordered: dedupe on the delivery id, order by `created_at`. ## Licensing | Tier | display | redistribute | rag | train | audio | resell | | --- | --- | --- | --- | --- | --- | --- | | FREE | ✓ | – | – | – | – | – | | LITE | ✓ | – | – | – | – | – | | STANDARD | ✓ | – | ✓ | – | – | – | | PRO | ✓ | ✓ | ✓ | – | ✓ | – | Invinite data may be shown and, from PRO, redistributed inside the licensee\'s own product with attribution (\"Source: Invinite\" on screen or in the API response that carries it). It may never be resold, relicensed, white-labelled or offered as a data feed as the licensee\'s own data, at any tier, under any contract. Policy version: 2026-10-draft. Draft — pending counsel sign-off. Audio files carry a forensic watermark that identifies the recording. Audio is subject to per-company takedown and may not be re-hosted. SEC data: Figures and filings originate from SEC EDGAR; the standardisation, mapping and derived metrics are Invinite\'s. News: News text is Invinite\'s own summary of the issuer\'s or the SEC\'s publication (the publisher\'s text and media are never served); the licensee shows the attribution (publisher, source URL and date) next to it; the resale rule applies. PDF documents: Branded PDFs of transcripts and news items are permanent URLs to one shared file per version. They may be shown, downloaded and forwarded unmodified with the notice page intact; the resale rule applies unchanged. News PDFs carry Invinite\'s summary of the issuer\'s or the SEC\'s publication under the attribution stated on their notice page; a PDF disappears when the item is taken down or its source\'s reuse is denied. Every `/v1/_*` data operation carries `x-license`, the minimum use right its data ships with; `GET /status/licensing` serves the same matrix per route, rendered at [data.invinite.com/docs/licensing](https://data.invinite.com/docs/licensing). `/v1/me` and `/v1/me/usage` serve no licensed data and carry none. ## Status [`/status`](/status) reports whether each product family works (a status and its uptime over 7, 30 and 90 days); [`/status/licensing`](/status/licensing) serves the licensing matrix per route. The status routes need no API key and are cached for 5 minutes. The public status page is [status.data.invinite.com](https://status.data.invinite.com): a snapshot of `/status` every 15 minutes plus an external reachability probe of the API. Uptime is the share of requests answered without a server error, measured by the API per product family; a window with too little traffic to judge shows no figure. Status reflects the last 24 hours. Product families: Company, Financials, SEC Filings, Insider Trades, Institutional Ownership, IPOs, Market, Metadata, Earnings Calls, News, WebSocket, Account.
|
|
7
|
+
*
|
|
8
|
+
* The version of the OpenAPI document: 2026-11-11
|
|
9
|
+
*
|
|
10
|
+
*
|
|
11
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
12
|
+
* https://openapi-generator.tech
|
|
13
|
+
* Do not edit the class manually.
|
|
14
|
+
*/
|
|
15
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
16
|
+
exports.instanceOfEventPeriodicReport = instanceOfEventPeriodicReport;
|
|
17
|
+
exports.EventPeriodicReportFromJSON = EventPeriodicReportFromJSON;
|
|
18
|
+
exports.EventPeriodicReportFromJSONTyped = EventPeriodicReportFromJSONTyped;
|
|
19
|
+
exports.EventPeriodicReportToJSON = EventPeriodicReportToJSON;
|
|
20
|
+
exports.EventPeriodicReportToJSONTyped = EventPeriodicReportToJSONTyped;
|
|
21
|
+
/**
|
|
22
|
+
* Check if a given object implements the EventPeriodicReport interface.
|
|
23
|
+
*/
|
|
24
|
+
function instanceOfEventPeriodicReport(value) {
|
|
25
|
+
if (!('accession' in value) || value['accession'] === undefined)
|
|
26
|
+
return false;
|
|
27
|
+
if (!('form' in value) || value['form'] === undefined)
|
|
28
|
+
return false;
|
|
29
|
+
if (!('period_end' in value) || value['period_end'] === undefined)
|
|
30
|
+
return false;
|
|
31
|
+
if (!('filing_date' in value) || value['filing_date'] === undefined)
|
|
32
|
+
return false;
|
|
33
|
+
if (!('accepted_at' in value) || value['accepted_at'] === undefined)
|
|
34
|
+
return false;
|
|
35
|
+
if (!('edgar_index_url' in value) || value['edgar_index_url'] === undefined)
|
|
36
|
+
return false;
|
|
37
|
+
return true;
|
|
38
|
+
}
|
|
39
|
+
function EventPeriodicReportFromJSON(json) {
|
|
40
|
+
return EventPeriodicReportFromJSONTyped(json, false);
|
|
41
|
+
}
|
|
42
|
+
function EventPeriodicReportFromJSONTyped(json, ignoreDiscriminator) {
|
|
43
|
+
if (json == null) {
|
|
44
|
+
return json;
|
|
45
|
+
}
|
|
46
|
+
return {
|
|
47
|
+
'accession': json['accession'],
|
|
48
|
+
'form': json['form'],
|
|
49
|
+
'period_end': (json['period_end'] == null ? null : new Date(json['period_end'])),
|
|
50
|
+
'filing_date': (json['filing_date'] == null ? null : new Date(json['filing_date'])),
|
|
51
|
+
'accepted_at': (json['accepted_at'] == null ? null : new Date(json['accepted_at'])),
|
|
52
|
+
'edgar_index_url': json['edgar_index_url'],
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
function EventPeriodicReportToJSON(json) {
|
|
56
|
+
return EventPeriodicReportToJSONTyped(json, false);
|
|
57
|
+
}
|
|
58
|
+
function EventPeriodicReportToJSONTyped(value, ignoreDiscriminator = false) {
|
|
59
|
+
if (value == null) {
|
|
60
|
+
return value;
|
|
61
|
+
}
|
|
62
|
+
return {
|
|
63
|
+
'accession': value['accession'],
|
|
64
|
+
'form': value['form'],
|
|
65
|
+
'period_end': value['period_end'] == null ? value['period_end'] : value['period_end'].toISOString().substring(0, 10),
|
|
66
|
+
'filing_date': value['filing_date'] == null ? value['filing_date'] : value['filing_date'].toISOString().substring(0, 10),
|
|
67
|
+
'accepted_at': value['accepted_at'] == null ? value['accepted_at'] : value['accepted_at'].toISOString(),
|
|
68
|
+
'edgar_index_url': value['edgar_index_url'],
|
|
69
|
+
};
|
|
70
|
+
}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Invinite API
|
|
3
|
+
* Invinite financial data API. Each operation has a base credit cost: `x-credits` is the base cost; responses add 1 credit per started 1,000 rows beyond the first 1,000; `X-Credits-Charged` reports the final debit and `X-Credits-Remaining` what is left of the plan\'s included credits after it. A `304 Not Modified` costs nothing. `GET /v1/me/usage` returns your account\'s usage by day, product family and key (it costs no credits). **Coverage.** 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. A known company with no data in a family (for example no statements yet) answers 404 with `code: not_covered`; an empty page of a covered company stays 200 with an empty list. `GET /v1/companies` lists every known company. ## Webhooks Accounts on LITE and above subscribe with `POST /v1/webhooks` to the `event.*` lifecycle events (filtered by company) and, on STANDARD and above, to `news.published` (one delivery per new news item, filtered by the companies it mentions); see `x-webhooks` for each `data` object. What a subscription may hold depends on the plan (a create / update beyond it is refused with the plan\'s limit; `event.test` needs no subscription — the test route and the disabled notice send it to any subscription): | Plan | Webhooks | Events | CIKs per webhook | Keywords per webhook | |---|---|---|---|---| | FREE | 0 | — | — | — | | LITE | 5 | `.scheduled`, `.rescheduled`, `.started`, `.ended`, `.transcript_ready`, `.assets_ready` | ≤ 10 | — | | STANDARD | 15 | LITE + `.transcript_provisional`, `.transcript_corrected`, `.documents_updated`, `news.published` | ≤ 25 | — | | PRO / ENTERPRISE | 50 | STANDARD + `.guidance_flash`, `.keyword_hit` | ≤ 100 | ≤ 20 (on ≤ 10 webhooks) | Every delivery is a `POST` with `Content-Type: application/json`, `X-Invinite-Event`, `X-Invinite-Delivery` and `X-Invinite-Signature: t=<unix seconds>,v1=<hex>` where `v1` = HMAC-SHA256(secret, `<t>.<raw body>`); during a secret rotation the header carries one `v1` per valid secret. Reject a signature older than 5 minutes. Any 2xx within 10 s acknowledges; redirects are not followed. A failed delivery is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 12 h, 24 h (8 attempts in all, the same delivery id each time). A subscription is disabled after 8 consecutive dead-lettered deliveries (a final `event.test` with `notice: subscription_disabled` is sent). Deliveries are at-least-once and unordered: dedupe on the delivery id, order by `created_at`. ## Licensing | Tier | display | redistribute | rag | train | audio | resell | | --- | --- | --- | --- | --- | --- | --- | | FREE | ✓ | – | – | – | – | – | | LITE | ✓ | – | – | – | – | – | | STANDARD | ✓ | – | ✓ | – | – | – | | PRO | ✓ | ✓ | ✓ | – | ✓ | – | Invinite data may be shown and, from PRO, redistributed inside the licensee\'s own product with attribution (\"Source: Invinite\" on screen or in the API response that carries it). It may never be resold, relicensed, white-labelled or offered as a data feed as the licensee\'s own data, at any tier, under any contract. Policy version: 2026-10-draft. Draft — pending counsel sign-off. Audio files carry a forensic watermark that identifies the recording. Audio is subject to per-company takedown and may not be re-hosted. SEC data: Figures and filings originate from SEC EDGAR; the standardisation, mapping and derived metrics are Invinite\'s. News: News text is Invinite\'s own summary of the issuer\'s or the SEC\'s publication (the publisher\'s text and media are never served); the licensee shows the attribution (publisher, source URL and date) next to it; the resale rule applies. PDF documents: Branded PDFs of transcripts and news items are permanent URLs to one shared file per version. They may be shown, downloaded and forwarded unmodified with the notice page intact; the resale rule applies unchanged. News PDFs carry Invinite\'s summary of the issuer\'s or the SEC\'s publication under the attribution stated on their notice page; a PDF disappears when the item is taken down or its source\'s reuse is denied. Every `/v1/_*` data operation carries `x-license`, the minimum use right its data ships with; `GET /status/licensing` serves the same matrix per route, rendered at [data.invinite.com/docs/licensing](https://data.invinite.com/docs/licensing). `/v1/me` and `/v1/me/usage` serve no licensed data and carry none. ## Status [`/status`](/status) reports whether each product family works (a status and its uptime over 7, 30 and 90 days); [`/status/licensing`](/status/licensing) serves the licensing matrix per route. The status routes need no API key and are cached for 5 minutes. The public status page is [status.data.invinite.com](https://status.data.invinite.com): a snapshot of `/status` every 15 minutes plus an external reachability probe of the API. Uptime is the share of requests answered without a server error, measured by the API per product family; a window with too little traffic to judge shows no figure. Status reflects the last 24 hours. Product families: Company, Financials, SEC Filings, Insider Trades, Institutional Ownership, IPOs, Market, Metadata, Earnings Calls, News, WebSocket, Account.
|
|
4
|
+
*
|
|
5
|
+
* The version of the OpenAPI document: 2026-11-11
|
|
6
|
+
*
|
|
7
|
+
*
|
|
8
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
9
|
+
* https://openapi-generator.tech
|
|
10
|
+
* Do not edit the class manually.
|
|
11
|
+
*/
|
|
12
|
+
/**
|
|
13
|
+
* The results filing: the earnings 8-K / 6-K (or its first attributed filing) whose EDGAR acceptance stamped `results_released_at`. Read the document with the SEC filing operations by `accession`. null before the results are filed. Appended 2026-11
|
|
14
|
+
* @export
|
|
15
|
+
* @interface EventResultsFiling
|
|
16
|
+
*/
|
|
17
|
+
export interface EventResultsFiling {
|
|
18
|
+
/**
|
|
19
|
+
* SEC accession number (0000320193-26-000024)
|
|
20
|
+
* @type {string}
|
|
21
|
+
* @memberof EventResultsFiling
|
|
22
|
+
*/
|
|
23
|
+
accession: string;
|
|
24
|
+
/**
|
|
25
|
+
* Form type (8-K, 8-K/A, 6-K, 6-K/A)
|
|
26
|
+
* @type {string}
|
|
27
|
+
* @memberof EventResultsFiling
|
|
28
|
+
*/
|
|
29
|
+
form: string;
|
|
30
|
+
/**
|
|
31
|
+
* EDGAR acceptance time (ISO 8601 UTC)
|
|
32
|
+
* @type {Date}
|
|
33
|
+
* @memberof EventResultsFiling
|
|
34
|
+
*/
|
|
35
|
+
accepted_at: Date | null;
|
|
36
|
+
/**
|
|
37
|
+
* The filing's EDGAR index page; null when the CIK is unknown
|
|
38
|
+
* @type {string}
|
|
39
|
+
* @memberof EventResultsFiling
|
|
40
|
+
*/
|
|
41
|
+
edgar_index_url: string | null;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Check if a given object implements the EventResultsFiling interface.
|
|
45
|
+
*/
|
|
46
|
+
export declare function instanceOfEventResultsFiling(value: object): value is EventResultsFiling;
|
|
47
|
+
export declare function EventResultsFilingFromJSON(json: any): EventResultsFiling;
|
|
48
|
+
export declare function EventResultsFilingFromJSONTyped(json: any, ignoreDiscriminator: boolean): EventResultsFiling;
|
|
49
|
+
export declare function EventResultsFilingToJSON(json: any): EventResultsFiling;
|
|
50
|
+
export declare function EventResultsFilingToJSONTyped(value?: EventResultsFiling | null, ignoreDiscriminator?: boolean): any;
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/* tslint:disable */
|
|
3
|
+
/* eslint-disable */
|
|
4
|
+
/**
|
|
5
|
+
* Invinite API
|
|
6
|
+
* Invinite financial data API. Each operation has a base credit cost: `x-credits` is the base cost; responses add 1 credit per started 1,000 rows beyond the first 1,000; `X-Credits-Charged` reports the final debit and `X-Credits-Remaining` what is left of the plan\'s included credits after it. A `304 Not Modified` costs nothing. `GET /v1/me/usage` returns your account\'s usage by day, product family and key (it costs no credits). **Coverage.** 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. A known company with no data in a family (for example no statements yet) answers 404 with `code: not_covered`; an empty page of a covered company stays 200 with an empty list. `GET /v1/companies` lists every known company. ## Webhooks Accounts on LITE and above subscribe with `POST /v1/webhooks` to the `event.*` lifecycle events (filtered by company) and, on STANDARD and above, to `news.published` (one delivery per new news item, filtered by the companies it mentions); see `x-webhooks` for each `data` object. What a subscription may hold depends on the plan (a create / update beyond it is refused with the plan\'s limit; `event.test` needs no subscription — the test route and the disabled notice send it to any subscription): | Plan | Webhooks | Events | CIKs per webhook | Keywords per webhook | |---|---|---|---|---| | FREE | 0 | — | — | — | | LITE | 5 | `.scheduled`, `.rescheduled`, `.started`, `.ended`, `.transcript_ready`, `.assets_ready` | ≤ 10 | — | | STANDARD | 15 | LITE + `.transcript_provisional`, `.transcript_corrected`, `.documents_updated`, `news.published` | ≤ 25 | — | | PRO / ENTERPRISE | 50 | STANDARD + `.guidance_flash`, `.keyword_hit` | ≤ 100 | ≤ 20 (on ≤ 10 webhooks) | Every delivery is a `POST` with `Content-Type: application/json`, `X-Invinite-Event`, `X-Invinite-Delivery` and `X-Invinite-Signature: t=<unix seconds>,v1=<hex>` where `v1` = HMAC-SHA256(secret, `<t>.<raw body>`); during a secret rotation the header carries one `v1` per valid secret. Reject a signature older than 5 minutes. Any 2xx within 10 s acknowledges; redirects are not followed. A failed delivery is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 12 h, 24 h (8 attempts in all, the same delivery id each time). A subscription is disabled after 8 consecutive dead-lettered deliveries (a final `event.test` with `notice: subscription_disabled` is sent). Deliveries are at-least-once and unordered: dedupe on the delivery id, order by `created_at`. ## Licensing | Tier | display | redistribute | rag | train | audio | resell | | --- | --- | --- | --- | --- | --- | --- | | FREE | ✓ | – | – | – | – | – | | LITE | ✓ | – | – | – | – | – | | STANDARD | ✓ | – | ✓ | – | – | – | | PRO | ✓ | ✓ | ✓ | – | ✓ | – | Invinite data may be shown and, from PRO, redistributed inside the licensee\'s own product with attribution (\"Source: Invinite\" on screen or in the API response that carries it). It may never be resold, relicensed, white-labelled or offered as a data feed as the licensee\'s own data, at any tier, under any contract. Policy version: 2026-10-draft. Draft — pending counsel sign-off. Audio files carry a forensic watermark that identifies the recording. Audio is subject to per-company takedown and may not be re-hosted. SEC data: Figures and filings originate from SEC EDGAR; the standardisation, mapping and derived metrics are Invinite\'s. News: News text is Invinite\'s own summary of the issuer\'s or the SEC\'s publication (the publisher\'s text and media are never served); the licensee shows the attribution (publisher, source URL and date) next to it; the resale rule applies. PDF documents: Branded PDFs of transcripts and news items are permanent URLs to one shared file per version. They may be shown, downloaded and forwarded unmodified with the notice page intact; the resale rule applies unchanged. News PDFs carry Invinite\'s summary of the issuer\'s or the SEC\'s publication under the attribution stated on their notice page; a PDF disappears when the item is taken down or its source\'s reuse is denied. Every `/v1/_*` data operation carries `x-license`, the minimum use right its data ships with; `GET /status/licensing` serves the same matrix per route, rendered at [data.invinite.com/docs/licensing](https://data.invinite.com/docs/licensing). `/v1/me` and `/v1/me/usage` serve no licensed data and carry none. ## Status [`/status`](/status) reports whether each product family works (a status and its uptime over 7, 30 and 90 days); [`/status/licensing`](/status/licensing) serves the licensing matrix per route. The status routes need no API key and are cached for 5 minutes. The public status page is [status.data.invinite.com](https://status.data.invinite.com): a snapshot of `/status` every 15 minutes plus an external reachability probe of the API. Uptime is the share of requests answered without a server error, measured by the API per product family; a window with too little traffic to judge shows no figure. Status reflects the last 24 hours. Product families: Company, Financials, SEC Filings, Insider Trades, Institutional Ownership, IPOs, Market, Metadata, Earnings Calls, News, WebSocket, Account.
|
|
7
|
+
*
|
|
8
|
+
* The version of the OpenAPI document: 2026-11-11
|
|
9
|
+
*
|
|
10
|
+
*
|
|
11
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
12
|
+
* https://openapi-generator.tech
|
|
13
|
+
* Do not edit the class manually.
|
|
14
|
+
*/
|
|
15
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
16
|
+
exports.instanceOfEventResultsFiling = instanceOfEventResultsFiling;
|
|
17
|
+
exports.EventResultsFilingFromJSON = EventResultsFilingFromJSON;
|
|
18
|
+
exports.EventResultsFilingFromJSONTyped = EventResultsFilingFromJSONTyped;
|
|
19
|
+
exports.EventResultsFilingToJSON = EventResultsFilingToJSON;
|
|
20
|
+
exports.EventResultsFilingToJSONTyped = EventResultsFilingToJSONTyped;
|
|
21
|
+
/**
|
|
22
|
+
* Check if a given object implements the EventResultsFiling interface.
|
|
23
|
+
*/
|
|
24
|
+
function instanceOfEventResultsFiling(value) {
|
|
25
|
+
if (!('accession' in value) || value['accession'] === undefined)
|
|
26
|
+
return false;
|
|
27
|
+
if (!('form' in value) || value['form'] === undefined)
|
|
28
|
+
return false;
|
|
29
|
+
if (!('accepted_at' in value) || value['accepted_at'] === undefined)
|
|
30
|
+
return false;
|
|
31
|
+
if (!('edgar_index_url' in value) || value['edgar_index_url'] === undefined)
|
|
32
|
+
return false;
|
|
33
|
+
return true;
|
|
34
|
+
}
|
|
35
|
+
function EventResultsFilingFromJSON(json) {
|
|
36
|
+
return EventResultsFilingFromJSONTyped(json, false);
|
|
37
|
+
}
|
|
38
|
+
function EventResultsFilingFromJSONTyped(json, ignoreDiscriminator) {
|
|
39
|
+
if (json == null) {
|
|
40
|
+
return json;
|
|
41
|
+
}
|
|
42
|
+
return {
|
|
43
|
+
'accession': json['accession'],
|
|
44
|
+
'form': json['form'],
|
|
45
|
+
'accepted_at': (json['accepted_at'] == null ? null : new Date(json['accepted_at'])),
|
|
46
|
+
'edgar_index_url': json['edgar_index_url'],
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
function EventResultsFilingToJSON(json) {
|
|
50
|
+
return EventResultsFilingToJSONTyped(json, false);
|
|
51
|
+
}
|
|
52
|
+
function EventResultsFilingToJSONTyped(value, ignoreDiscriminator = false) {
|
|
53
|
+
if (value == null) {
|
|
54
|
+
return value;
|
|
55
|
+
}
|
|
56
|
+
return {
|
|
57
|
+
'accession': value['accession'],
|
|
58
|
+
'form': value['form'],
|
|
59
|
+
'accepted_at': value['accepted_at'] == null ? value['accepted_at'] : value['accepted_at'].toISOString(),
|
|
60
|
+
'edgar_index_url': value['edgar_index_url'],
|
|
61
|
+
};
|
|
62
|
+
}
|
package/dist/models/index.d.ts
CHANGED
|
@@ -42,7 +42,9 @@ export * from './EventComparisonNewTopicsInner';
|
|
|
42
42
|
export * from './EventComparisonPriorEvent';
|
|
43
43
|
export * from './EventComparisonSlideDiff';
|
|
44
44
|
export * from './EventObservationsInner';
|
|
45
|
+
export * from './EventPeriodicReport';
|
|
45
46
|
export * from './EventRef';
|
|
47
|
+
export * from './EventResultsFiling';
|
|
46
48
|
export * from './EventStats';
|
|
47
49
|
export * from './EventStatsEvent';
|
|
48
50
|
export * from './EventTypeCatalogEntry';
|
package/dist/models/index.js
CHANGED
|
@@ -60,7 +60,9 @@ __exportStar(require("./EventComparisonNewTopicsInner"), exports);
|
|
|
60
60
|
__exportStar(require("./EventComparisonPriorEvent"), exports);
|
|
61
61
|
__exportStar(require("./EventComparisonSlideDiff"), exports);
|
|
62
62
|
__exportStar(require("./EventObservationsInner"), exports);
|
|
63
|
+
__exportStar(require("./EventPeriodicReport"), exports);
|
|
63
64
|
__exportStar(require("./EventRef"), exports);
|
|
65
|
+
__exportStar(require("./EventResultsFiling"), exports);
|
|
64
66
|
__exportStar(require("./EventStats"), exports);
|
|
65
67
|
__exportStar(require("./EventStatsEvent"), exports);
|
|
66
68
|
__exportStar(require("./EventTypeCatalogEntry"), exports);
|
package/docs/Event.md
CHANGED
|
@@ -36,6 +36,8 @@ Name | Type
|
|
|
36
36
|
`has_documents` | boolean
|
|
37
37
|
`webcast_url` | string
|
|
38
38
|
`video` | [EventVideo](EventVideo.md)
|
|
39
|
+
`results_filing` | [EventResultsFiling](EventResultsFiling.md)
|
|
40
|
+
`periodic_report` | [EventPeriodicReport](EventPeriodicReport.md)
|
|
39
41
|
`observations` | [Array<EventObservationsInner>](EventObservationsInner.md)
|
|
40
42
|
`calendar` | [EventCalendar](EventCalendar.md)
|
|
41
43
|
|
|
@@ -75,6 +77,8 @@ const example = {
|
|
|
75
77
|
"has_documents": null,
|
|
76
78
|
"webcast_url": null,
|
|
77
79
|
"video": null,
|
|
80
|
+
"results_filing": null,
|
|
81
|
+
"periodic_report": null,
|
|
78
82
|
"observations": null,
|
|
79
83
|
"calendar": null,
|
|
80
84
|
} satisfies Event
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
|
|
2
|
+
# EventPeriodicReport
|
|
3
|
+
|
|
4
|
+
The periodic report of the event\'s fiscal period: the 10-Q (10-QT) for a fiscal Q1–Q3, the 10-K (10-KT, 20-F, 40-F) for a fiscal Q4. null until it is filed and attributed; never an amendment. A foreign filer has none for Q1–Q3 (no quarterly form). Appended 2026-11
|
|
5
|
+
|
|
6
|
+
## Properties
|
|
7
|
+
|
|
8
|
+
Name | Type
|
|
9
|
+
------------ | -------------
|
|
10
|
+
`accession` | string
|
|
11
|
+
`form` | string
|
|
12
|
+
`period_end` | Date
|
|
13
|
+
`filing_date` | Date
|
|
14
|
+
`accepted_at` | Date
|
|
15
|
+
`edgar_index_url` | string
|
|
16
|
+
|
|
17
|
+
## Example
|
|
18
|
+
|
|
19
|
+
```typescript
|
|
20
|
+
import type { EventPeriodicReport } from '@invinite-org/data-api-client'
|
|
21
|
+
|
|
22
|
+
// TODO: Update the object below with actual values
|
|
23
|
+
const example = {
|
|
24
|
+
"accession": null,
|
|
25
|
+
"form": null,
|
|
26
|
+
"period_end": null,
|
|
27
|
+
"filing_date": null,
|
|
28
|
+
"accepted_at": null,
|
|
29
|
+
"edgar_index_url": null,
|
|
30
|
+
} satisfies EventPeriodicReport
|
|
31
|
+
|
|
32
|
+
console.log(example)
|
|
33
|
+
|
|
34
|
+
// Convert the instance to a JSON string
|
|
35
|
+
const exampleJSON: string = JSON.stringify(example)
|
|
36
|
+
console.log(exampleJSON)
|
|
37
|
+
|
|
38
|
+
// Parse the JSON string back to an object
|
|
39
|
+
const exampleParsed = JSON.parse(exampleJSON) as EventPeriodicReport
|
|
40
|
+
console.log(exampleParsed)
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
|
|
44
|
+
|
|
45
|
+
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
|
|
2
|
+
# EventResultsFiling
|
|
3
|
+
|
|
4
|
+
The results filing: the earnings 8-K / 6-K (or its first attributed filing) whose EDGAR acceptance stamped `results_released_at`. Read the document with the SEC filing operations by `accession`. null before the results are filed. Appended 2026-11
|
|
5
|
+
|
|
6
|
+
## Properties
|
|
7
|
+
|
|
8
|
+
Name | Type
|
|
9
|
+
------------ | -------------
|
|
10
|
+
`accession` | string
|
|
11
|
+
`form` | string
|
|
12
|
+
`accepted_at` | Date
|
|
13
|
+
`edgar_index_url` | string
|
|
14
|
+
|
|
15
|
+
## Example
|
|
16
|
+
|
|
17
|
+
```typescript
|
|
18
|
+
import type { EventResultsFiling } from '@invinite-org/data-api-client'
|
|
19
|
+
|
|
20
|
+
// TODO: Update the object below with actual values
|
|
21
|
+
const example = {
|
|
22
|
+
"accession": null,
|
|
23
|
+
"form": null,
|
|
24
|
+
"accepted_at": null,
|
|
25
|
+
"edgar_index_url": null,
|
|
26
|
+
} satisfies EventResultsFiling
|
|
27
|
+
|
|
28
|
+
console.log(example)
|
|
29
|
+
|
|
30
|
+
// Convert the instance to a JSON string
|
|
31
|
+
const exampleJSON: string = JSON.stringify(example)
|
|
32
|
+
console.log(exampleJSON)
|
|
33
|
+
|
|
34
|
+
// Parse the JSON string back to an object
|
|
35
|
+
const exampleParsed = JSON.parse(exampleJSON) as EventResultsFiling
|
|
36
|
+
console.log(exampleParsed)
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
|
|
40
|
+
|
|
41
|
+
|
package/package.json
CHANGED
package/src/models/Event.ts
CHANGED
|
@@ -13,6 +13,20 @@
|
|
|
13
13
|
*/
|
|
14
14
|
|
|
15
15
|
import { mapValues } from '../runtime';
|
|
16
|
+
import type { EventPeriodicReport } from './EventPeriodicReport';
|
|
17
|
+
import {
|
|
18
|
+
EventPeriodicReportFromJSON,
|
|
19
|
+
EventPeriodicReportFromJSONTyped,
|
|
20
|
+
EventPeriodicReportToJSON,
|
|
21
|
+
EventPeriodicReportToJSONTyped,
|
|
22
|
+
} from './EventPeriodicReport';
|
|
23
|
+
import type { EventResultsFiling } from './EventResultsFiling';
|
|
24
|
+
import {
|
|
25
|
+
EventResultsFilingFromJSON,
|
|
26
|
+
EventResultsFilingFromJSONTyped,
|
|
27
|
+
EventResultsFilingToJSON,
|
|
28
|
+
EventResultsFilingToJSONTyped,
|
|
29
|
+
} from './EventResultsFiling';
|
|
16
30
|
import type { EventVideo } from './EventVideo';
|
|
17
31
|
import {
|
|
18
32
|
EventVideoFromJSON,
|
|
@@ -215,6 +229,18 @@ export interface Event {
|
|
|
215
229
|
* @memberof Event
|
|
216
230
|
*/
|
|
217
231
|
video: EventVideo | null;
|
|
232
|
+
/**
|
|
233
|
+
*
|
|
234
|
+
* @type {EventResultsFiling}
|
|
235
|
+
* @memberof Event
|
|
236
|
+
*/
|
|
237
|
+
results_filing?: EventResultsFiling | null;
|
|
238
|
+
/**
|
|
239
|
+
*
|
|
240
|
+
* @type {EventPeriodicReport}
|
|
241
|
+
* @memberof Event
|
|
242
|
+
*/
|
|
243
|
+
periodic_report?: EventPeriodicReport | null;
|
|
218
244
|
/**
|
|
219
245
|
* Date / time observations, oldest first (at most 50)
|
|
220
246
|
* @type {Array<EventObservationsInner>}
|
|
@@ -366,6 +392,8 @@ export function EventFromJSONTyped(json: any, ignoreDiscriminator: boolean): Eve
|
|
|
366
392
|
'has_documents': json['has_documents'],
|
|
367
393
|
'webcast_url': json['webcast_url'],
|
|
368
394
|
'video': EventVideoFromJSON(json['video']),
|
|
395
|
+
'results_filing': json['results_filing'] == null ? undefined : EventResultsFilingFromJSON(json['results_filing']),
|
|
396
|
+
'periodic_report': json['periodic_report'] == null ? undefined : EventPeriodicReportFromJSON(json['periodic_report']),
|
|
369
397
|
'observations': json['observations'] == null ? undefined : ((json['observations'] as Array<any>).map(EventObservationsInnerFromJSON)),
|
|
370
398
|
'calendar': json['calendar'] == null ? undefined : EventCalendarFromJSON(json['calendar']),
|
|
371
399
|
};
|
|
@@ -411,6 +439,8 @@ export function EventToJSONTyped(value?: Event | null, ignoreDiscriminator: bool
|
|
|
411
439
|
'has_documents': value['has_documents'],
|
|
412
440
|
'webcast_url': value['webcast_url'],
|
|
413
441
|
'video': EventVideoToJSON(value['video']),
|
|
442
|
+
'results_filing': EventResultsFilingToJSON(value['results_filing']),
|
|
443
|
+
'periodic_report': EventPeriodicReportToJSON(value['periodic_report']),
|
|
414
444
|
'observations': value['observations'] == null ? undefined : ((value['observations'] as Array<any>).map(EventObservationsInnerToJSON)),
|
|
415
445
|
'calendar': EventCalendarToJSON(value['calendar']),
|
|
416
446
|
};
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
/* tslint:disable */
|
|
2
|
+
/* eslint-disable */
|
|
3
|
+
/**
|
|
4
|
+
* Invinite API
|
|
5
|
+
* Invinite financial data API. Each operation has a base credit cost: `x-credits` is the base cost; responses add 1 credit per started 1,000 rows beyond the first 1,000; `X-Credits-Charged` reports the final debit and `X-Credits-Remaining` what is left of the plan\'s included credits after it. A `304 Not Modified` costs nothing. `GET /v1/me/usage` returns your account\'s usage by day, product family and key (it costs no credits). **Coverage.** 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. A known company with no data in a family (for example no statements yet) answers 404 with `code: not_covered`; an empty page of a covered company stays 200 with an empty list. `GET /v1/companies` lists every known company. ## Webhooks Accounts on LITE and above subscribe with `POST /v1/webhooks` to the `event.*` lifecycle events (filtered by company) and, on STANDARD and above, to `news.published` (one delivery per new news item, filtered by the companies it mentions); see `x-webhooks` for each `data` object. What a subscription may hold depends on the plan (a create / update beyond it is refused with the plan\'s limit; `event.test` needs no subscription — the test route and the disabled notice send it to any subscription): | Plan | Webhooks | Events | CIKs per webhook | Keywords per webhook | |---|---|---|---|---| | FREE | 0 | — | — | — | | LITE | 5 | `.scheduled`, `.rescheduled`, `.started`, `.ended`, `.transcript_ready`, `.assets_ready` | ≤ 10 | — | | STANDARD | 15 | LITE + `.transcript_provisional`, `.transcript_corrected`, `.documents_updated`, `news.published` | ≤ 25 | — | | PRO / ENTERPRISE | 50 | STANDARD + `.guidance_flash`, `.keyword_hit` | ≤ 100 | ≤ 20 (on ≤ 10 webhooks) | Every delivery is a `POST` with `Content-Type: application/json`, `X-Invinite-Event`, `X-Invinite-Delivery` and `X-Invinite-Signature: t=<unix seconds>,v1=<hex>` where `v1` = HMAC-SHA256(secret, `<t>.<raw body>`); during a secret rotation the header carries one `v1` per valid secret. Reject a signature older than 5 minutes. Any 2xx within 10 s acknowledges; redirects are not followed. A failed delivery is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 12 h, 24 h (8 attempts in all, the same delivery id each time). A subscription is disabled after 8 consecutive dead-lettered deliveries (a final `event.test` with `notice: subscription_disabled` is sent). Deliveries are at-least-once and unordered: dedupe on the delivery id, order by `created_at`. ## Licensing | Tier | display | redistribute | rag | train | audio | resell | | --- | --- | --- | --- | --- | --- | --- | | FREE | ✓ | – | – | – | – | – | | LITE | ✓ | – | – | – | – | – | | STANDARD | ✓ | – | ✓ | – | – | – | | PRO | ✓ | ✓ | ✓ | – | ✓ | – | Invinite data may be shown and, from PRO, redistributed inside the licensee\'s own product with attribution (\"Source: Invinite\" on screen or in the API response that carries it). It may never be resold, relicensed, white-labelled or offered as a data feed as the licensee\'s own data, at any tier, under any contract. Policy version: 2026-10-draft. Draft — pending counsel sign-off. Audio files carry a forensic watermark that identifies the recording. Audio is subject to per-company takedown and may not be re-hosted. SEC data: Figures and filings originate from SEC EDGAR; the standardisation, mapping and derived metrics are Invinite\'s. News: News text is Invinite\'s own summary of the issuer\'s or the SEC\'s publication (the publisher\'s text and media are never served); the licensee shows the attribution (publisher, source URL and date) next to it; the resale rule applies. PDF documents: Branded PDFs of transcripts and news items are permanent URLs to one shared file per version. They may be shown, downloaded and forwarded unmodified with the notice page intact; the resale rule applies unchanged. News PDFs carry Invinite\'s summary of the issuer\'s or the SEC\'s publication under the attribution stated on their notice page; a PDF disappears when the item is taken down or its source\'s reuse is denied. Every `/v1/_*` data operation carries `x-license`, the minimum use right its data ships with; `GET /status/licensing` serves the same matrix per route, rendered at [data.invinite.com/docs/licensing](https://data.invinite.com/docs/licensing). `/v1/me` and `/v1/me/usage` serve no licensed data and carry none. ## Status [`/status`](/status) reports whether each product family works (a status and its uptime over 7, 30 and 90 days); [`/status/licensing`](/status/licensing) serves the licensing matrix per route. The status routes need no API key and are cached for 5 minutes. The public status page is [status.data.invinite.com](https://status.data.invinite.com): a snapshot of `/status` every 15 minutes plus an external reachability probe of the API. Uptime is the share of requests answered without a server error, measured by the API per product family; a window with too little traffic to judge shows no figure. Status reflects the last 24 hours. Product families: Company, Financials, SEC Filings, Insider Trades, Institutional Ownership, IPOs, Market, Metadata, Earnings Calls, News, WebSocket, Account.
|
|
6
|
+
*
|
|
7
|
+
* The version of the OpenAPI document: 2026-11-11
|
|
8
|
+
*
|
|
9
|
+
*
|
|
10
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
11
|
+
* https://openapi-generator.tech
|
|
12
|
+
* Do not edit the class manually.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
import { mapValues } from '../runtime';
|
|
16
|
+
/**
|
|
17
|
+
* The periodic report of the event's fiscal period: the 10-Q (10-QT) for a fiscal Q1–Q3, the 10-K (10-KT, 20-F, 40-F) for a fiscal Q4. null until it is filed and attributed; never an amendment. A foreign filer has none for Q1–Q3 (no quarterly form). Appended 2026-11
|
|
18
|
+
* @export
|
|
19
|
+
* @interface EventPeriodicReport
|
|
20
|
+
*/
|
|
21
|
+
export interface EventPeriodicReport {
|
|
22
|
+
/**
|
|
23
|
+
* SEC accession number (0000320193-26-000024)
|
|
24
|
+
* @type {string}
|
|
25
|
+
* @memberof EventPeriodicReport
|
|
26
|
+
*/
|
|
27
|
+
accession: string;
|
|
28
|
+
/**
|
|
29
|
+
* Form type (10-Q, 10-QT, 10-K, 10-KT, 20-F, 40-F)
|
|
30
|
+
* @type {string}
|
|
31
|
+
* @memberof EventPeriodicReport
|
|
32
|
+
*/
|
|
33
|
+
form: string;
|
|
34
|
+
/**
|
|
35
|
+
* Period end the filing reports (YYYY-MM-DD)
|
|
36
|
+
* @type {Date}
|
|
37
|
+
* @memberof EventPeriodicReport
|
|
38
|
+
*/
|
|
39
|
+
period_end: Date | null;
|
|
40
|
+
/**
|
|
41
|
+
* SEC filing date (YYYY-MM-DD)
|
|
42
|
+
* @type {Date}
|
|
43
|
+
* @memberof EventPeriodicReport
|
|
44
|
+
*/
|
|
45
|
+
filing_date: Date | null;
|
|
46
|
+
/**
|
|
47
|
+
* EDGAR acceptance time (ISO 8601 UTC)
|
|
48
|
+
* @type {Date}
|
|
49
|
+
* @memberof EventPeriodicReport
|
|
50
|
+
*/
|
|
51
|
+
accepted_at: Date | null;
|
|
52
|
+
/**
|
|
53
|
+
* The filing's EDGAR index page; null when the CIK is unknown
|
|
54
|
+
* @type {string}
|
|
55
|
+
* @memberof EventPeriodicReport
|
|
56
|
+
*/
|
|
57
|
+
edgar_index_url: string | null;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* Check if a given object implements the EventPeriodicReport interface.
|
|
62
|
+
*/
|
|
63
|
+
export function instanceOfEventPeriodicReport(value: object): value is EventPeriodicReport {
|
|
64
|
+
if (!('accession' in value) || value['accession'] === undefined) return false;
|
|
65
|
+
if (!('form' in value) || value['form'] === undefined) return false;
|
|
66
|
+
if (!('period_end' in value) || value['period_end'] === undefined) return false;
|
|
67
|
+
if (!('filing_date' in value) || value['filing_date'] === undefined) return false;
|
|
68
|
+
if (!('accepted_at' in value) || value['accepted_at'] === undefined) return false;
|
|
69
|
+
if (!('edgar_index_url' in value) || value['edgar_index_url'] === undefined) return false;
|
|
70
|
+
return true;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
export function EventPeriodicReportFromJSON(json: any): EventPeriodicReport {
|
|
74
|
+
return EventPeriodicReportFromJSONTyped(json, false);
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
export function EventPeriodicReportFromJSONTyped(json: any, ignoreDiscriminator: boolean): EventPeriodicReport {
|
|
78
|
+
if (json == null) {
|
|
79
|
+
return json;
|
|
80
|
+
}
|
|
81
|
+
return {
|
|
82
|
+
|
|
83
|
+
'accession': json['accession'],
|
|
84
|
+
'form': json['form'],
|
|
85
|
+
'period_end': (json['period_end'] == null ? null : new Date(json['period_end'])),
|
|
86
|
+
'filing_date': (json['filing_date'] == null ? null : new Date(json['filing_date'])),
|
|
87
|
+
'accepted_at': (json['accepted_at'] == null ? null : new Date(json['accepted_at'])),
|
|
88
|
+
'edgar_index_url': json['edgar_index_url'],
|
|
89
|
+
};
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
export function EventPeriodicReportToJSON(json: any): EventPeriodicReport {
|
|
93
|
+
return EventPeriodicReportToJSONTyped(json, false);
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
export function EventPeriodicReportToJSONTyped(value?: EventPeriodicReport | null, ignoreDiscriminator: boolean = false): any {
|
|
97
|
+
if (value == null) {
|
|
98
|
+
return value;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
return {
|
|
102
|
+
|
|
103
|
+
'accession': value['accession'],
|
|
104
|
+
'form': value['form'],
|
|
105
|
+
'period_end': value['period_end'] == null ? value['period_end'] : value['period_end'].toISOString().substring(0,10),
|
|
106
|
+
'filing_date': value['filing_date'] == null ? value['filing_date'] : value['filing_date'].toISOString().substring(0,10),
|
|
107
|
+
'accepted_at': value['accepted_at'] == null ? value['accepted_at'] : value['accepted_at'].toISOString(),
|
|
108
|
+
'edgar_index_url': value['edgar_index_url'],
|
|
109
|
+
};
|
|
110
|
+
}
|
|
111
|
+
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
/* tslint:disable */
|
|
2
|
+
/* eslint-disable */
|
|
3
|
+
/**
|
|
4
|
+
* Invinite API
|
|
5
|
+
* Invinite financial data API. Each operation has a base credit cost: `x-credits` is the base cost; responses add 1 credit per started 1,000 rows beyond the first 1,000; `X-Credits-Charged` reports the final debit and `X-Credits-Remaining` what is left of the plan\'s included credits after it. A `304 Not Modified` costs nothing. `GET /v1/me/usage` returns your account\'s usage by day, product family and key (it costs no credits). **Coverage.** 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. A known company with no data in a family (for example no statements yet) answers 404 with `code: not_covered`; an empty page of a covered company stays 200 with an empty list. `GET /v1/companies` lists every known company. ## Webhooks Accounts on LITE and above subscribe with `POST /v1/webhooks` to the `event.*` lifecycle events (filtered by company) and, on STANDARD and above, to `news.published` (one delivery per new news item, filtered by the companies it mentions); see `x-webhooks` for each `data` object. What a subscription may hold depends on the plan (a create / update beyond it is refused with the plan\'s limit; `event.test` needs no subscription — the test route and the disabled notice send it to any subscription): | Plan | Webhooks | Events | CIKs per webhook | Keywords per webhook | |---|---|---|---|---| | FREE | 0 | — | — | — | | LITE | 5 | `.scheduled`, `.rescheduled`, `.started`, `.ended`, `.transcript_ready`, `.assets_ready` | ≤ 10 | — | | STANDARD | 15 | LITE + `.transcript_provisional`, `.transcript_corrected`, `.documents_updated`, `news.published` | ≤ 25 | — | | PRO / ENTERPRISE | 50 | STANDARD + `.guidance_flash`, `.keyword_hit` | ≤ 100 | ≤ 20 (on ≤ 10 webhooks) | Every delivery is a `POST` with `Content-Type: application/json`, `X-Invinite-Event`, `X-Invinite-Delivery` and `X-Invinite-Signature: t=<unix seconds>,v1=<hex>` where `v1` = HMAC-SHA256(secret, `<t>.<raw body>`); during a secret rotation the header carries one `v1` per valid secret. Reject a signature older than 5 minutes. Any 2xx within 10 s acknowledges; redirects are not followed. A failed delivery is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 12 h, 24 h (8 attempts in all, the same delivery id each time). A subscription is disabled after 8 consecutive dead-lettered deliveries (a final `event.test` with `notice: subscription_disabled` is sent). Deliveries are at-least-once and unordered: dedupe on the delivery id, order by `created_at`. ## Licensing | Tier | display | redistribute | rag | train | audio | resell | | --- | --- | --- | --- | --- | --- | --- | | FREE | ✓ | – | – | – | – | – | | LITE | ✓ | – | – | – | – | – | | STANDARD | ✓ | – | ✓ | – | – | – | | PRO | ✓ | ✓ | ✓ | – | ✓ | – | Invinite data may be shown and, from PRO, redistributed inside the licensee\'s own product with attribution (\"Source: Invinite\" on screen or in the API response that carries it). It may never be resold, relicensed, white-labelled or offered as a data feed as the licensee\'s own data, at any tier, under any contract. Policy version: 2026-10-draft. Draft — pending counsel sign-off. Audio files carry a forensic watermark that identifies the recording. Audio is subject to per-company takedown and may not be re-hosted. SEC data: Figures and filings originate from SEC EDGAR; the standardisation, mapping and derived metrics are Invinite\'s. News: News text is Invinite\'s own summary of the issuer\'s or the SEC\'s publication (the publisher\'s text and media are never served); the licensee shows the attribution (publisher, source URL and date) next to it; the resale rule applies. PDF documents: Branded PDFs of transcripts and news items are permanent URLs to one shared file per version. They may be shown, downloaded and forwarded unmodified with the notice page intact; the resale rule applies unchanged. News PDFs carry Invinite\'s summary of the issuer\'s or the SEC\'s publication under the attribution stated on their notice page; a PDF disappears when the item is taken down or its source\'s reuse is denied. Every `/v1/_*` data operation carries `x-license`, the minimum use right its data ships with; `GET /status/licensing` serves the same matrix per route, rendered at [data.invinite.com/docs/licensing](https://data.invinite.com/docs/licensing). `/v1/me` and `/v1/me/usage` serve no licensed data and carry none. ## Status [`/status`](/status) reports whether each product family works (a status and its uptime over 7, 30 and 90 days); [`/status/licensing`](/status/licensing) serves the licensing matrix per route. The status routes need no API key and are cached for 5 minutes. The public status page is [status.data.invinite.com](https://status.data.invinite.com): a snapshot of `/status` every 15 minutes plus an external reachability probe of the API. Uptime is the share of requests answered without a server error, measured by the API per product family; a window with too little traffic to judge shows no figure. Status reflects the last 24 hours. Product families: Company, Financials, SEC Filings, Insider Trades, Institutional Ownership, IPOs, Market, Metadata, Earnings Calls, News, WebSocket, Account.
|
|
6
|
+
*
|
|
7
|
+
* The version of the OpenAPI document: 2026-11-11
|
|
8
|
+
*
|
|
9
|
+
*
|
|
10
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
11
|
+
* https://openapi-generator.tech
|
|
12
|
+
* Do not edit the class manually.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
import { mapValues } from '../runtime';
|
|
16
|
+
/**
|
|
17
|
+
* The results filing: the earnings 8-K / 6-K (or its first attributed filing) whose EDGAR acceptance stamped `results_released_at`. Read the document with the SEC filing operations by `accession`. null before the results are filed. Appended 2026-11
|
|
18
|
+
* @export
|
|
19
|
+
* @interface EventResultsFiling
|
|
20
|
+
*/
|
|
21
|
+
export interface EventResultsFiling {
|
|
22
|
+
/**
|
|
23
|
+
* SEC accession number (0000320193-26-000024)
|
|
24
|
+
* @type {string}
|
|
25
|
+
* @memberof EventResultsFiling
|
|
26
|
+
*/
|
|
27
|
+
accession: string;
|
|
28
|
+
/**
|
|
29
|
+
* Form type (8-K, 8-K/A, 6-K, 6-K/A)
|
|
30
|
+
* @type {string}
|
|
31
|
+
* @memberof EventResultsFiling
|
|
32
|
+
*/
|
|
33
|
+
form: string;
|
|
34
|
+
/**
|
|
35
|
+
* EDGAR acceptance time (ISO 8601 UTC)
|
|
36
|
+
* @type {Date}
|
|
37
|
+
* @memberof EventResultsFiling
|
|
38
|
+
*/
|
|
39
|
+
accepted_at: Date | null;
|
|
40
|
+
/**
|
|
41
|
+
* The filing's EDGAR index page; null when the CIK is unknown
|
|
42
|
+
* @type {string}
|
|
43
|
+
* @memberof EventResultsFiling
|
|
44
|
+
*/
|
|
45
|
+
edgar_index_url: string | null;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* Check if a given object implements the EventResultsFiling interface.
|
|
50
|
+
*/
|
|
51
|
+
export function instanceOfEventResultsFiling(value: object): value is EventResultsFiling {
|
|
52
|
+
if (!('accession' in value) || value['accession'] === undefined) return false;
|
|
53
|
+
if (!('form' in value) || value['form'] === undefined) return false;
|
|
54
|
+
if (!('accepted_at' in value) || value['accepted_at'] === undefined) return false;
|
|
55
|
+
if (!('edgar_index_url' in value) || value['edgar_index_url'] === undefined) return false;
|
|
56
|
+
return true;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
export function EventResultsFilingFromJSON(json: any): EventResultsFiling {
|
|
60
|
+
return EventResultsFilingFromJSONTyped(json, false);
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
export function EventResultsFilingFromJSONTyped(json: any, ignoreDiscriminator: boolean): EventResultsFiling {
|
|
64
|
+
if (json == null) {
|
|
65
|
+
return json;
|
|
66
|
+
}
|
|
67
|
+
return {
|
|
68
|
+
|
|
69
|
+
'accession': json['accession'],
|
|
70
|
+
'form': json['form'],
|
|
71
|
+
'accepted_at': (json['accepted_at'] == null ? null : new Date(json['accepted_at'])),
|
|
72
|
+
'edgar_index_url': json['edgar_index_url'],
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
export function EventResultsFilingToJSON(json: any): EventResultsFiling {
|
|
77
|
+
return EventResultsFilingToJSONTyped(json, false);
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
export function EventResultsFilingToJSONTyped(value?: EventResultsFiling | null, ignoreDiscriminator: boolean = false): any {
|
|
81
|
+
if (value == null) {
|
|
82
|
+
return value;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
return {
|
|
86
|
+
|
|
87
|
+
'accession': value['accession'],
|
|
88
|
+
'form': value['form'],
|
|
89
|
+
'accepted_at': value['accepted_at'] == null ? value['accepted_at'] : value['accepted_at'].toISOString(),
|
|
90
|
+
'edgar_index_url': value['edgar_index_url'],
|
|
91
|
+
};
|
|
92
|
+
}
|
|
93
|
+
|
package/src/models/index.ts
CHANGED
|
@@ -44,7 +44,9 @@ export * from './EventComparisonNewTopicsInner';
|
|
|
44
44
|
export * from './EventComparisonPriorEvent';
|
|
45
45
|
export * from './EventComparisonSlideDiff';
|
|
46
46
|
export * from './EventObservationsInner';
|
|
47
|
+
export * from './EventPeriodicReport';
|
|
47
48
|
export * from './EventRef';
|
|
49
|
+
export * from './EventResultsFiling';
|
|
48
50
|
export * from './EventStats';
|
|
49
51
|
export * from './EventStatsEvent';
|
|
50
52
|
export * from './EventTypeCatalogEntry';
|