Felo API PlatformFelo API Platform
Alle endpoints van Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Resultatenoverzicht ophalen

Server:https://openapi.felo.ai
Clientbibliotheken

Financial Data

​

Company fundamentals, financial statements, market prices and economic data.

Financial Data Operaties

Resultatenoverzicht ophalen

​

Gerapporteerde resultaten voor één aandeel, werkelijke cijfers tegenover schattingen. Elke vermelding bevat report_period, fiscal_period, filing_date, filing_url en accession_number, een quarterly-blok met revenue, estimated_revenue, revenue_surprise en revenue_surprise_pct, dezelfde drietallen voor earnings_per_share, plus velden voor de verandering op jaarbasis. Het retourneert ook signals: upstream berekende vlaggen zoals EPS_BEAT met een headline en de onderliggende actual / estimate / surprise_pct. ticker is vereist en is de enige parameter. Gebruik het voor wat een bedrijf daadwerkelijk heeft gerapporteerd. Voor de vooruitkijkende consensus die nog niet heeft plaatsgevonden gebruik je get_financial_analyst_estimates.

Prijsreferentie

  • Metering: Vaste kostenbasis per geslaagd verzoek.
  • Referentieschatting per verzoek: USD 0.02.
  • Referentieklantvermenigvuldiger: 1.0. Pas deze niet opnieuw toe op een afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Queryparameters
  • cursor
    Type: string

    Ondoorzichtige pagineringscursor uit de next_page_url van een eerdere respons. Als deze wordt opgegeven, worden alle andere queryparameters genegeerd: de cursor bevat de filters van de oorspronkelijke aanvraag. Behandel hem als ondoorzichtig; construeer of wijzig hem niet.

  • limit
    Type: integer
    min.:  
    1
    max.:  
    40

    Aantal meest recente rapportageperioden aan indieningen dat wordt geretourneerd, gesorteerd op (report_period DESC, filing_date ASC). Het aantal geretourneerde vermeldingen kan limit overschrijden wanneer een recente periode zowel een 8-K als een 10-Q / 10-K bevat. Waarden boven 40 worden beperkt tot 40. Niet-positieve of niet-gehele waarden retourneren 400. Dit is het totaal over alle pagina's, niet de paginagrootte: elke pagina bevat maximaal 10 records, gekoppeld via next_page_url.

  • ticker
    Type: string
    verplicht

    Het tickersymbool (bijv. AAPL).

Responsen
  • 200
    Type: object · ResponseE40Feb4D3D6B_EarningsResponse

    Resultatenrespons

    • earnings
      Type: array object[] · ResponseE40Feb4D3D6B_EarningsRecord[]

      Platte lijst van SEC-inzendingen voor de ticker, gesorteerd op (report_period DESC, filing_date ASC). Bij limit=N worden inzendingen voor maximaal N report_periods geretourneerd; het aantal items kan N overschrijden wanneer een recente periode zowel een 8-K als een 10-Q/10-K bevat.

      • accession_number
        Type: string
        verplicht

        SEC-toegangsnummer dat de inzending identificeert.

      • filing_date
        Type: string Formaat: date
        verplicht

        Kalenderdag waarop de SEC de inzending heeft geaccepteerd, in Eastern Time (de operationele tijdzone van de SEC). Kalenderdag-tegenhanger van filing_datetime.

      • filing_url
        Type: string Formaat: uri
        verplicht

        URL naar de SEC-inzending.

      • report_period
        Type: string Formaat: date
        verplicht

        Verslagperiode die deze inzending bestrijkt.

      • source_type
        Type: string enum
        verplicht

        Het SEC-formuliertype waarop deze inzending berust.

        waarden
        • 8-K
        • 10-Q
        • 10-K
        • 20-F
      • ticker
        Type: string
        verplicht

        Het aangevraagde tickersymbool.

      • annual
        Type: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
        • capital_expenditure
          Type: number | null
        • capital_expenditure_chg
          Type: number

          Procentuele verandering van de investeringsuitgaven ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • capital_expenditure_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de investeringsuitgaven ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • cash_and_equivalents
          Type: number | null
        • change_in_cash_and_equivalents
          Type: number | null
        • earnings_per_share
          Type: number | null
        • earnings_per_share_chg
          Type: number

          Procentuele verandering van de winst per aandeel ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • earnings_per_share_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de winst per aandeel ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • free_cash_flow
          Type: number | null
        • free_cash_flow_chg
          Type: number

          Procentuele verandering van de vrije cashflow ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • free_cash_flow_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de vrije cashflow ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • gross_margin
          Type: number

          Brutomarge als decimaal (gross_profit / revenue). Wordt alleen geretourneerd als deze berekenbaar is.

        • gross_margin_chg_bps
          Type: number

          Absolute verandering van de brutomarge ten opzichte van de vorige periode in basispunten (bijv. 200,0 = marge met 200 bp gestegen). Wordt alleen geretourneerd als deze berekenbaar is.

        • gross_margin_chg_pct
          Type: number

          Procentuele verandering van de brutomarge ten opzichte van de vorige periode als decimaal. Wordt alleen geretourneerd als deze berekenbaar is.

        • gross_margin_yoy_chg_bps
          Type: number

          Jaar-op-jaarverandering van de brutomarge ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, in basispunten. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • gross_margin_yoy_chg_pct
          Type: number

          Procentuele jaar-op-jaarverandering van de brutomarge ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • gross_profit
          Type: number | null
        • gross_profit_chg
          Type: number

          Procentuele verandering van de brutowinst ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • gross_profit_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de brutowinst ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_cash_flow_from_financing
          Type: number | null
        • net_cash_flow_from_financing_chg
          Type: number

          Procentuele verandering van de netto cashflow uit financieringsactiviteiten ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_cash_flow_from_financing_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de netto cashflow uit financieringsactiviteiten ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_cash_flow_from_investing
          Type: number | null
        • net_cash_flow_from_investing_chg
          Type: number

          Procentuele verandering van de netto cashflow uit investeringsactiviteiten ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_cash_flow_from_investing_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de netto cashflow uit investeringsactiviteiten ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_cash_flow_from_operations
          Type: number | null
        • net_cash_flow_from_operations_chg
          Type: number

          Procentuele verandering van de netto cashflow uit operationele activiteiten ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_cash_flow_from_operations_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de netto cashflow uit operationele activiteiten ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_income
          Type: number | null
        • net_income_chg
          Type: number

          Procentuele verandering van de nettowinst ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_income_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de nettowinst ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_margin
          Type: number

          Nettomarge als decimaal (net_income / revenue). Wordt alleen geretourneerd als deze berekenbaar is.

        • net_margin_chg_bps
          Type: number

          Absolute verandering van de nettomarge ten opzichte van de vorige periode in basispunten. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_margin_chg_pct
          Type: number

          Procentuele verandering van de nettomarge ten opzichte van de vorige periode als decimaal. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_margin_yoy_chg_bps
          Type: number

          Jaar-op-jaarverandering van de nettomarge ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, in basispunten. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_margin_yoy_chg_pct
          Type: number

          Procentuele jaar-op-jaarverandering van de nettomarge ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • operating_income
          Type: number | null
        • operating_income_chg
          Type: number

          Procentuele verandering van het operationele resultaat ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • operating_income_yoy_chg
          Type: number

          Jaar-op-jaarverandering van het operationele resultaat ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • operating_margin
          Type: number

          Operationele marge als decimaal (operating_income / revenue). Wordt alleen geretourneerd als deze berekenbaar is.

        • operating_margin_chg_bps
          Type: number

          Absolute verandering van de operationele marge ten opzichte van de vorige periode in basispunten. Wordt alleen geretourneerd als deze berekenbaar is.

        • operating_margin_chg_pct
          Type: number

          Procentuele verandering van de operationele marge ten opzichte van de vorige periode als decimaal. Wordt alleen geretourneerd als deze berekenbaar is.

        • operating_margin_yoy_chg_bps
          Type: number

          Jaar-op-jaarverandering van de operationele marge ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, in basispunten. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • operating_margin_yoy_chg_pct
          Type: number

          Procentuele jaar-op-jaarverandering van de operationele marge ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • revenue
          Type: number | null
        • revenue_chg
          Type: number

          Procentuele verandering van de omzet ten opzichte van de vorige periode als decimaal (bijv. 0,10 = +10%). Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • revenue_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de omzet ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • shareholders_equity
          Type: number | null
        • total_assets
          Type: number | null
        • total_debt
          Type: number | null
        • total_liabilities
          Type: number | null
        • weighted_average_shares
          Type: number | null
        • weighted_average_shares_diluted
          Type: number | null
      • currency
        Type: string

        ISO-valutacode (bijv. USD).

      • filing_datetime
        Type: string | null Formaat: date-time

        Tijdstempel binnen een dag waarop de SEC de inzending in Eastern Time heeft geaccepteerd. Afkomstig uit het veld acceptanceDateTime van de SEC in de EDGAR submissions-API. Hoort bij filing_date (kalenderdagprecisie van dezelfde gebeurtenis).

      • filing_window
        Type: string | null enum

        Marktsessie op het moment dat de SEC de inzending accepteerde, geëvalueerd in Eastern Time. PRE_MARKET = werkdag 04:00–09:30 ET. DURING_MARKET = werkdag 09:30–16:00 ET. AFTER_HOURS = werkdag buiten de reguliere handelsuren. WEEKEND = zaterdag of zondag. Null wanneer filing_datetime niet beschikbaar is.

        waarden
        • PRE_MARKET
        • DURING_MARKET
        • AFTER_HOURS
        • WEEKEND
      • fiscal_period
        Type: string

        Label van de fiscale periode (bijv. 2026-Q1 of 2025-FY).

      • quarterly
        Type: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
        • capital_expenditure
          Type: number | null
        • capital_expenditure_chg
          Type: number

          Procentuele verandering van de investeringsuitgaven ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • capital_expenditure_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de investeringsuitgaven ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • cash_and_equivalents
          Type: number | null
        • change_in_cash_and_equivalents
          Type: number | null
        • earnings_per_share
          Type: number | null
        • earnings_per_share_chg
          Type: number

          Procentuele verandering van de winst per aandeel ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • earnings_per_share_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de winst per aandeel ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • free_cash_flow
          Type: number | null
        • free_cash_flow_chg
          Type: number

          Procentuele verandering van de vrije cashflow ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • free_cash_flow_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de vrije cashflow ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • gross_margin
          Type: number

          Brutomarge als decimaal (gross_profit / revenue). Wordt alleen geretourneerd als deze berekenbaar is.

        • gross_margin_chg_bps
          Type: number

          Absolute verandering van de brutomarge ten opzichte van de vorige periode in basispunten (bijv. 200,0 = marge met 200 bp gestegen). Wordt alleen geretourneerd als deze berekenbaar is.

        • gross_margin_chg_pct
          Type: number

          Procentuele verandering van de brutomarge ten opzichte van de vorige periode als decimaal. Wordt alleen geretourneerd als deze berekenbaar is.

        • gross_margin_yoy_chg_bps
          Type: number

          Jaar-op-jaarverandering van de brutomarge ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, in basispunten. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • gross_margin_yoy_chg_pct
          Type: number

          Procentuele jaar-op-jaarverandering van de brutomarge ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • gross_profit
          Type: number | null
        • gross_profit_chg
          Type: number

          Procentuele verandering van de brutowinst ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • gross_profit_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de brutowinst ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_cash_flow_from_financing
          Type: number | null
        • net_cash_flow_from_financing_chg
          Type: number

          Procentuele verandering van de netto cashflow uit financieringsactiviteiten ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_cash_flow_from_financing_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de netto cashflow uit financieringsactiviteiten ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_cash_flow_from_investing
          Type: number | null
        • net_cash_flow_from_investing_chg
          Type: number

          Procentuele verandering van de netto cashflow uit investeringsactiviteiten ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_cash_flow_from_investing_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de netto cashflow uit investeringsactiviteiten ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_cash_flow_from_operations
          Type: number | null
        • net_cash_flow_from_operations_chg
          Type: number

          Procentuele verandering van de netto cashflow uit operationele activiteiten ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_cash_flow_from_operations_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de netto cashflow uit operationele activiteiten ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_income
          Type: number | null
        • net_income_chg
          Type: number

          Procentuele verandering van de nettowinst ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_income_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de nettowinst ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_margin
          Type: number

          Nettomarge als decimaal (net_income / revenue). Wordt alleen geretourneerd als deze berekenbaar is.

        • net_margin_chg_bps
          Type: number

          Absolute verandering van de nettomarge ten opzichte van de vorige periode in basispunten. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_margin_chg_pct
          Type: number

          Procentuele verandering van de nettomarge ten opzichte van de vorige periode als decimaal. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_margin_yoy_chg_bps
          Type: number

          Jaar-op-jaarverandering van de nettomarge ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, in basispunten. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • net_margin_yoy_chg_pct
          Type: number

          Procentuele jaar-op-jaarverandering van de nettomarge ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • operating_income
          Type: number | null
        • operating_income_chg
          Type: number

          Procentuele verandering van het operationele resultaat ten opzichte van de vorige periode als decimaal. Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • operating_income_yoy_chg
          Type: number

          Jaar-op-jaarverandering van het operationele resultaat ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • operating_margin
          Type: number

          Operationele marge als decimaal (operating_income / revenue). Wordt alleen geretourneerd als deze berekenbaar is.

        • operating_margin_chg_bps
          Type: number

          Absolute verandering van de operationele marge ten opzichte van de vorige periode in basispunten. Wordt alleen geretourneerd als deze berekenbaar is.

        • operating_margin_chg_pct
          Type: number

          Procentuele verandering van de operationele marge ten opzichte van de vorige periode als decimaal. Wordt alleen geretourneerd als deze berekenbaar is.

        • operating_margin_yoy_chg_bps
          Type: number

          Jaar-op-jaarverandering van de operationele marge ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, in basispunten. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • operating_margin_yoy_chg_pct
          Type: number

          Procentuele jaar-op-jaarverandering van de operationele marge ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • revenue
          Type: number | null
        • revenue_chg
          Type: number

          Procentuele verandering van de omzet ten opzichte van de vorige periode als decimaal (bijv. 0,10 = +10%). Sequentieel in de kwartaalrespons, jaar-op-jaar in de jaarrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • revenue_yoy_chg
          Type: number

          Jaar-op-jaarverandering van de omzet ten opzichte van hetzelfde fiscale kwartaal een jaar eerder, als decimaal. Alleen in de kwartaalrespons. Wordt alleen geretourneerd als deze berekenbaar is.

        • shareholders_equity
          Type: number | null
        • total_assets
          Type: number | null
        • total_debt
          Type: number | null
        • total_liabilities
          Type: number | null
        • weighted_average_shares
          Type: number | null
        • weighted_average_shares_diluted
          Type: number | null
      • signals
        Type: array object[] · ResponseE40Feb4D3D6B_Signal[]

        Samengestelde, marktbewegende inzichten uit deze inzending. Elk item heeft een vooraf gerenderde headline, gestructureerde details en een importance-rangschikking. Wordt alleen geretourneerd wanneer voor dit item minstens één signaal afgaat; anders vervalt het veld. Maximaal 8 per item, gesorteerd op HIGH → MEDIUM → LOW.

        Een samengesteld, marktbewegend inzicht uit deze inzending. De vooraf gerenderde headline is geschikt voor directe weergave; details bevat gestructureerde velden voor filteren en programmatisch gebruik. Signalen worden in prioriteitsvolgorde geretourneerd (meest materieel eerst); het type zelf codeert de omvang (bijv. STRONG_REVENUE_INCREASE vs. REVENUE_INCREASE).

        • headline
          Type: string
          verplicht

          Vooraf gerenderde, mensleesbare samenvatting die geschikt is voor directe weergave.

        • type
          Type: string enum
          verplicht

          Signaalcategorie. MARGIN_EXPANSION/MARGIN_CONTRACTION: een van de marges (bruto, operationeel of netto) is jaar-op-jaar met ≥ 100 bp veranderd. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: in de inzending gerapporteerde wijziging van toekomstgerichte guidance. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: het best- of slechtst presterende rapporteerbare segment op basis van organische omzetgroei. NON_GAAP_DIVERGENCE: een aangepast/non-GAAP-cijfer wijkt materieel af van het bijbehorende GAAP-cijfer over dezelfde periode. BACKLOG_SURGE/BACKLOG_DECLINE: orderportefeuille of resterende prestatieverplichtingen zijn jaar-op-jaar met ≥ 20% veranderd. REVENUE_INCREASE/STRONG_REVENUE_INCREASE en DECLINE-varianten: getrapte jaar-op-jaaromzetverandering (omvang ≥ 10% / ≥ 20%). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE en DECLINE-varianten: getrapte jaar-op-jaarverandering van de nettowinst (≥ 15% / ≥ 30%). EPS_INCREASE/STRONG_EPS_INCREASE en DECLINE-varianten: getrapte jaar-op-jaarverandering van de winst per aandeel (≥ 15% / ≥ 30%); onafhankelijk van de nettowinst, omdat aandeleninkoop de EPS-beweging kan versterken. CAPEX_INCREASE/STRONG_CAPEX_INCREASE en DECLINE-varianten: getrapte jaar-op-jaarverandering van de investeringsuitgaven in bestedingsomvang (≥ 15% / ≥ 30%).

          waarden
          • MARGIN_EXPANSION
          • MARGIN_CONTRACTION
          • GUIDANCE_RAISED
          • GUIDANCE_LOWERED
          • GUIDANCE_REAFFIRMED
        • details
          Type: object

          Gestructureerde velden specifiek voor het signaaltype. De inhoud varieert: guidancesignalen bevatten low, high, point_estimate, prior_value, revision_pct; segment-signalen bevatten best, worst, spread_pp; non-GAAP-signalen bevatten gaap_field, non_gaap_value, gaap_value, divergence_pct; groeisignalen bevatten current, yoy_chg. Nullwaarden worden weggelaten. Raadpleeg de typespecifieke voorbeelden.

          • propertyName
            Type: anything
        • metric
          Type: string | null

          De metriek waarnaar dit signaal verwijst, indien van toepassing (bijv. revenue, earnings_per_share, operating_margin of een guidance-/KPI-metrieknaam).

        • period
          Type: string | null

          De fiscale periode waarnaar het signaal verwijst (bijv. 2026-Q1, FY 2026). Signalen voor toekomstige guidance verwijzen naar de verwachte periode; financiële signalen verwijzen naar de verslagperiode van deze inzending.

    • next_page_url
      Type: string

      Absolute URL van de volgende pagina met resultaten. Alleen aanwezig wanneer er meer resultaten zijn; vraag deze ongewijzigd aan om door te gaan. Elke pagina bevat maximaal 10 records.

    application/json
  • 400

    Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.

  • 401

    Een geldige Felo-API-sleutel is vereist.

  • 402

    Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.

  • 403

    Het account mag deze bewerking niet uitvoeren.

  • 429

    Een verzoek- of bestedingslimiet is bereikt.

  • 502

    De dienst kon het verzoek niet voltooien.

  • 503

    De API of factureringsdienst is tijdelijk niet beschikbaar.

  • 504

    Er is een time-out opgetreden bij het verwerken van het verzoek.

  • default

    Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

    application/json
Request Example for get/v1/beta/financial/earnings
curl 'https://openapi.felo.ai/v1/beta/financial/earnings?ticker=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "earnings": [
    {
      "ticker": "string",
      "report_period": "2026-10-26",
      "fiscal_period": "string",
      "currency": "string",
      "source_type": "8-K",
      "filing_date": "2026-10-26",
      "filing_datetime": null,
      "filing_window": "PRE_MARKET",
      "signals": [
        {
          "type": "MARGIN_EXPANSION",
          "metric": null,
          "period": null,
          "headline": "string",
          "details": {
            "additionalProperty": "anything"
          }
        }
      ],
      "filing_url": "https://example.com",
      "accession_number": "string",
      "quarterly": {
        "revenue": null,
        "revenue_chg": 1,
        "revenue_yoy_chg": 1,
        "earnings_per_share": null,
        "earnings_per_share_chg": 1,
        "earnings_per_share_yoy_chg": 1,
        "gross_profit": null,
        "gross_profit_chg": 1,
        "gross_profit_yoy_chg": 1,
        "gross_margin": 1,
        "gross_margin_chg_bps": 1,
        "gross_margin_chg_pct": 1,
        "gross_margin_yoy_chg_bps": 1,
        "gross_margin_yoy_chg_pct": 1,
        "operating_income": null,
        "operating_income_chg": 1,
        "operating_income_yoy_chg": 1,
        "operating_margin": 1,
        "operating_margin_chg_bps": 1,
        "operating_margin_chg_pct": 1,
        "operating_margin_yoy_chg_bps": 1,
        "operating_margin_yoy_chg_pct": 1,
        "net_income": null,
        "net_income_chg": 1,
        "net_income_yoy_chg": 1,
        "net_margin": 1,
        "net_margin_chg_bps": 1,
        "net_margin_chg_pct": 1,
        "net_margin_yoy_chg_bps": 1,
        "net_margin_yoy_chg_pct": 1,
        "weighted_average_shares": null,
        "weighted_average_shares_diluted": null,
        "cash_and_equivalents": null,
        "change_in_cash_and_equivalents": null,
        "total_debt": null,
        "total_assets": null,
        "total_liabilities": null,
        "shareholders_equity": null,
        "net_cash_flow_from_operations": null,
        "net_cash_flow_from_operations_chg": 1,
        "net_cash_flow_from_operations_yoy_chg": 1,
        "net_cash_flow_from_investing": null,
        "net_cash_flow_from_investing_chg": 1,
        "net_cash_flow_from_investing_yoy_chg": 1,
        "net_cash_flow_from_financing": null,
        "net_cash_flow_from_financing_chg": 1,
        "net_cash_flow_from_financing_yoy_chg": 1,
        "capital_expenditure": null,
        "capital_expenditure_chg": 1,
        "capital_expenditure_yoy_chg": 1,
        "free_cash_flow": null,
        "free_cash_flow_chg": 1,
        "free_cash_flow_yoy_chg": 1
      },
      "annual": {
        "revenue": null,
        "revenue_chg": 1,
        "revenue_yoy_chg": 1,
        "earnings_per_share": null,
        "earnings_per_share_chg": 1,
        "earnings_per_share_yoy_chg": 1,
        "gross_profit": null,
        "gross_profit_chg": 1,
        "gross_profit_yoy_chg": 1,
        "gross_margin": 1,
        "gross_margin_chg_bps": 1,
        "gross_margin_chg_pct": 1,
        "gross_margin_yoy_chg_bps": 1,
        "gross_margin_yoy_chg_pct": 1,
        "operating_income": null,
        "operating_income_chg": 1,
        "operating_income_yoy_chg": 1,
        "operating_margin": 1,
        "operating_margin_chg_bps": 1,
        "operating_margin_chg_pct": 1,
        "operating_margin_yoy_chg_bps": 1,
        "operating_margin_yoy_chg_pct": 1,
        "net_income": null,
        "net_income_chg": 1,
        "net_income_yoy_chg": 1,
        "net_margin": 1,
        "net_margin_chg_bps": 1,
        "net_margin_chg_pct": 1,
        "net_margin_yoy_chg_bps": 1,
        "net_margin_yoy_chg_pct": 1,
        "weighted_average_shares": null,
        "weighted_average_shares_diluted": null,
        "cash_and_equivalents": null,
        "change_in_cash_and_equivalents": null,
        "total_debt": null,
        "total_assets": null,
        "total_liabilities": null,
        "shareholders_equity": null,
        "net_cash_flow_from_operations": null,
        "net_cash_flow_from_operations_chg": 1,
        "net_cash_flow_from_operations_yoy_chg": 1,
        "net_cash_flow_from_investing": null,
        "net_cash_flow_from_investing_chg": 1,
        "net_cash_flow_from_investing_yoy_chg": 1,
        "net_cash_flow_from_financing": null,
        "net_cash_flow_from_financing_chg": 1,
        "net_cash_flow_from_financing_yoy_chg": 1,
        "capital_expenditure": null,
        "capital_expenditure_chg": 1,
        "capital_expenditure_yoy_chg": 1,
        "free_cash_flow": null,
        "free_cash_flow_chg": 1,
        "free_cash_flow_yoy_chg": 1
      }
    }
  ],
  "next_page_url": "string"
}
Get earnings snapshot