Filings

HAS_MCP_EQUIVALENT

List Changes

Qualitative wording changes between consecutive earnings press releases: what the filer started saying, stopped saying, or now says differently.

post/v0/filings/list_changes

Request

Base URL: https://api.ultralayer.ai
URL: https://api.ultralayer.ai/v0/filings/list_changes
Auth: HTTP bearer

Request body

start_timestampstring date-time nullable

System timestamp; Inclusive ISO 8601

end_timestampstring date-time nullable

System timestamp; Inclusive ISO 8601; null=realtime

limitinteger

symbolsstring[] nullable

Match any.

change_kindsstring[] nullable

Match any.

change_categoriesstring[] nullable

Match any.

impactstring[] nullable

Match any.

min_materiality_scorenumber

0-.2 reword; .2-.4 weak; .4-.6 mod; .6-.8 high; .8-1 must-read

fiscal_yearinteger nullable

fiscal_quarterinteger nullable

sort'timestamp' | 'materiality'

timestamp: newest first; materiality: highest materiality_score first.

detail'full' | 'standard' | 'essential'

essential:finding; standard:citable; full:all.

Example request

{
  "symbols": [
    "NVDA",
    "AAPL"
  ]
}

Response

Disclosure changes at detail=full.

symbolstring required

Listing symbol of the filer.

company_namestring nullable required

Filer name.

cikinteger nullable required

SEC CIK of the filer.

timestampstring date-time required

System timestamp of this change.

source_timestampstring date-time required

When the current release became public.

fiscal_yearinteger required

Filer fiscal year of the current release's completed period.

fiscal_quarterinteger nullable required

Filer fiscal quarter of the current release; null for a full-year report.

prior_fiscal_yearinteger required

Filer fiscal year of the prior release's completed period.

prior_fiscal_quarterinteger nullable required

Filer fiscal quarter of the prior release; null for a full-year report.

change_kind'added' | 'removed' | 'modified' required

added, removed, or modified.

change_categorystring required

Kind of disclosure that changed.

summarystring required

One sentence stating what changed.

current_quotestring nullable required

Evidencing sentence in the current release. Null on a removal.

prior_quotestring nullable required

Evidencing sentence in the prior release. Null on an addition.

materiality_scorenumber required

0-.2 reword; .2-.4 weak; .4-.6 mod; .6-.8 high; .8-1 must-read

impact'positive' | 'negative' | 'neutral' required

Which way the change moves a reader's view of the company.

Changes

No recorded changes to this operation across all 1 revision of this API.