Skip to content

Corporate intelligence ​

TNL collects SEC submission metadata and corporate announcements, retains immutable source observations, and publishes source-linked briefs for significant disclosures. Browse the Company Intelligence desk.

Authentication and limits ​

Send your existing TNL API key as Authorization: Bearer YOUR_KEY. Calls use the existing key verification and monthly quota. Missing/invalid credentials or exhausted quota return 401. These endpoints serve TNL corporate data separately from the BDYA /v1/intel/corporations family.

GET endpointResult
/v1/intel/corporate/resourcesCorporate resource paths and schema version
/v1/intel/companiesMonitored companies (CIK, name, tickers, exchanges)
/v1/intel/companies/{id}Company by ten-digit CIK or ticker
/v1/intel/companies/{id}/filingsRetained SEC filing metadata and revisions
/v1/intel/companies/{id}/announcementsAnnouncement metadata eligible for redistribution
/v1/intel/companies/{id}/eventsSignificant published company events
/v1/intel/eventsSignificant published events across companies

Collection responses contain data and nextCursor. Use limit (1–100, default 25) and the returned cursor. Ordering is newest retained sequence first, preserving stable paging as new records arrive. A null cursor ends the result set. All observation revisions remain accessible; IDs identify the source record, and source changes generate versioned event/brief IDs.

Filings, announcements and events support since and before inclusive ISO timestamps. For filings/announcements these filter original source publication time; for events they filter occurrence time. The events endpoint also accepts company (CIK/ticker) and type; company events accept type. Unsupported filters return 400 instead of being ignored. Unknown company/detail IDs return 404. Provider outages do not remove retained data.

sh
curl 'https://theneuralledger.com/v1/intel/companies/AAPL/filings?limit=25' \
  -H 'Authorization: Bearer YOUR_KEY'

Evidence and meaning ​

Filings include source URL, accession, form, report date, disclosed item codes, source publication time, observation time and rights basis. Events include company, source observation ID, event type, occurrence/detection times, significance reasons and verification status.

source_confirmed means the SEC submission metadata was retrieved; it does not independently validate an issuer's financial assertions. issuer_reported means an announcement is attributed to an issuer, not corroborated as fact. Material filing classes include periodic reports and selected 8-K items. Routine ownership filings are retained but do not automatically generate posts.

Only redistributable observations are returned through customer data endpoints. public_summary permission allows an original attributed brief but does not expose the underlying announcement record. internal records remain private. Raw provider payloads and source bodies are never returned by these endpoints. An empty announcement collection can mean no eligible records, not complete wire coverage.

Public reading endpoints ​

/api/corporate/briefs and /api/corporate/briefs/{id} provide published editorial content; /api/corporate/companies supplies the desk's company filter. Brief collections accept company CIK, since/before (TNL publication time), limit and cursor. Published briefs link to retained earlier briefs when updated; earlier URLs remain available permanently.

The current release produces factual filing and announcement briefs. It does not derive financial ratios from metadata or claim price impact, and does not include company fundamentals, market prices or webhooks. Those are separate expansion phases.

Corporate actions and earnings ​

GET /v1/intel/corporate-actions returns permanent earnings reports and evidence-backed guidance, acquisition/disposal and dividend disclosures. Use company (ticker or CIK), type (earnings, guidance, acquisition_disposal, dividend), since, before, limit (1–100) and cursor. Dates filter the source filing timestamp, not the TNL publication date. Actions are ordered by source filing date descending, with ingestion sequence breaking ties; nextCursor is an exclusive continuation cursor. Revisions remain in the collection.

GET /v1/intel/corporate-actions/{id} retrieves a retained report. GET /v1/intel/companies/{id}/corporate-actions accepts the same filters except company, which comes from the path. These endpoints use the existing API key and quota checks.

Reports include id, logicalId, companyId, type, title, summary, paragraphs, metrics, evidence, sourcePublishedAt, observedAt, publishedAt, accession, verification, status and supersedes. Each metric contains the full current and optional previous fact, absolute delta, optional percentChange and comparison reason. Evidence links identify the filing or exhibit; disclosure reports include a retained passage. supersedes links to the earlier permanent report if the same source report is revised.

Earnings are SEC-reported accounting results. Guidance remains management expectations; a dividend declaration does not prove payment, and an acquisition agreement does not prove completion. Unsupported terms and forecast deltas are not inferred. No analyst consensus comparisons are supplied.

Company financial observations ​

GET /v1/intel/companies/{id}/financials accepts metric, since, before, limit and cursor. Dates filter filing dates (midnight UTC for date-only SEC metadata). Supported metrics are revenue, net_income, eps_diluted, operating_cash_flow, cash, current_debt, noncurrent_debt, long_term_debt, assets and liabilities.

This is an archive of reported observations, not a latest-value snapshot. Multiple filings can report the same period; all retained values remain accessible. Each fact includes its SEC taxonomy/concept, units, numeric value, start/end dates, duration, filing accession/form/date, reported fiscal-year/period labels, observation time, source URL and verification status. Fiscal labels belong to the filing and must not replace the fact's exact period dates. Coverage currently uses selected US-GAAP entity-wide concepts; unavailable/custom/IFRS concepts are not fabricated.

Comparisons require the same company, accounting concept and unit, with corresponding prior-year period ends and comparable durations. Only prior figures disclosed by the current filing date are considered. Conflicting figures suppress a comparison; zero or negative prior values suppress percentage growth. Comparative figures may already incorporate amendments. Quarterly and year-to-date values are kept distinct. Cash flow can be cumulative even when revenue is quarterly; exact dates are shown for every metric. Debt components are not automatically summed.

Public reports: Corporate Actions & Earnings.

AI/ADES digestion ​

Filings, announcements, financial facts, retained disclosure documents and corporate actions enter the shared source intelligence pipeline. Source collections and corporate-action detail expose intelligence, including sourceKey, processing status and validated results. Published reports display an additive entity/asset/impact section. New publications wait for completed source/action digestion; historical publications remain available during backfill.

A filing notice is often insufficient to infer an economic consequence. The service may return insufficient_evidence with matched entities and no impact paths. Historical financial observations preserve their units and reporting periods; grouped observations do not imply a comparable time series or a current price signal.

The Neural Ledger API