Felo API PlatformFelo API Platform
Tous les endpoints Financial Data
v0.2.0-beta
OpenAPI 3.1.0

Obtenir tous les états financiers

Serveur:https://openapi.felo.ai
Bibliothèques clientes

Financial Data

​

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

Financial Data Opérations

Obtenir tous les états financiers

​

Les trois états financiers d'une société en un seul appel. Renvoie un objet financials contenant income_statements, balance_sheets et cash_flow_statements, chacun de la même forme que celle renvoyée par les outils dédiés. period est obligatoire (annual, quarterly ou ttm) ; identifiez la société par ticker ou cik et plafonnez avec limit. Utilisez-le lorsque vous avez besoin de la vue complète et feriez sinon trois appels. Lorsque vous n'avez besoin que d'un état, get_financial_financials_income_statements, get_financial_financials_balance_sheets ou get_financial_financials_cash_flow_statements renvoient bien moins de données ; lorsque vous avez besoin de quelques champs nommés sur plusieurs sociétés, post_financial_financials_search_line_items est encore plus restreint.

Référence tarifaire

  • Mesure : base de coût fixe par requête réussie.
  • Estimation de référence par requête : USD 0.02.
  • Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.

Paramètres de requête
  • cik
    Type: string

    La Central Index Key (CIK) de la société.

  • cursor
    Type: string

    Curseur de pagination opaque provenant du next_page_url d'une réponse précédente. Lorsqu'il est fourni, tous les autres paramètres de requête sont ignorés : le curseur transporte les filtres de la requête d'origine. Traitez-le comme opaque ; ne le construisez ni ne le modifiez.

  • filing_date
    Type: string Format: date

    Filtre par date exacte de dépôt auprès de la SEC au format YYYY-MM-DD. Les lignes sans date de dépôt connue sont exclues.

  • filing_date_gt
    Type: string Format: date

    Filtre par date de dépôt auprès de la SEC postérieure à date, au format YYYY-MM-DD. Les lignes sans date de dépôt connue sont exclues.

  • filing_date_gte
    Type: string Format: date

    Filtre par date de dépôt auprès de la SEC postérieure ou égale à date, au format YYYY-MM-DD. Les lignes sans date de dépôt connue sont exclues.

  • filing_date_lt
    Type: string Format: date

    Filtre par date de dépôt auprès de la SEC antérieure à date, au format YYYY-MM-DD. Les lignes sans date de dépôt connue sont exclues.

  • filing_date_lte
    Type: string Format: date

    Filtre par date de dépôt auprès de la SEC antérieure ou égale à date, au format YYYY-MM-DD. Utile pour les requêtes à un instant précis : ne renvoie que les données déjà déposées publiquement à la date indiquée. Les lignes sans date de dépôt connue sont exclues.

  • limit
    Type: integer Format: int32

    Le nombre maximal d'états financiers à renvoyer. Il s'agit du total sur toutes les pages, et non de la taille d'une page : chaque page contient jusqu'à 10 enregistrements, reliés par next_page_url.

  • period
    Type: string enum
    obligatoire

    La période des états financiers.

    valeurs
    • annual
    • quarterly
    • ttm
  • report_period
    Type: string Format: date

    Filtre par date exacte de la période du rapport au format YYYY-MM-DD.

  • report_period_gt
    Type: string Format: date

    Filtrer par période de rapport supérieure à la date au format YYYY-MM-DD.

  • report_period_gte
    Type: string Format: date

    Filtrer par période de rapport supérieure ou égale à la date au format YYYY-MM-DD.

  • report_period_lt
    Type: string Format: date

    Filtrer par période de rapport inférieure à la date au format YYYY-MM-DD.

  • report_period_lte
    Type: string Format: date

    Filtrer par période de rapport inférieure ou égale à la date au format YYYY-MM-DD.

  • ticker
    Type: string

    Le symbole boursier. Obligatoire si cik n'est pas fourni.

Réponses
  • 200
    Type: object · ResponseE40Feb4D3D6B_FinancialsResponse

    Réponse d'états financiers

    • financials
      Type: object
      • balance_sheets
        Type: array object[] · ResponseE40Feb4D3D6B_BalanceSheet[]
        • accession_number
          Type: string | null

          Le numéro d'accession SEC du document.

        • accumulated_other_comprehensive_income
          Type: number

          Les autres éléments du résultat global accumulés de la société.

        • cash_and_equivalents
          Type: number

          La trésorerie et les équivalents de trésorerie de la société.

        • currency
          Type: string

          La devise dans laquelle les données financières sont présentées.

        • current_assets
          Type: number

          Les actifs courants de la société.

        • current_debt
          Type: number

          La dette à court terme de la société.

        • current_investments
          Type: number

          Les investissements à court terme de la société.

        • current_liabilities
          Type: number

          Le passif courant de la société.

        • deferred_revenue
          Type: number

          Les produits constatés d'avance de la société.

        • deposit_liabilities
          Type: number

          Les passifs de dépôt de la société.

        • filing_date
          Type: string | null Format: date

          Jour calendaire auquel la SEC a accepté le document, heure de l'Est (fuseau horaire de fonctionnement de la SEC). Paire de jour calendaire avec filing_datetime. null lorsqu'aucun document SEC daté n'est associé à la ligne.

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

          Horodatage à précision infra-journalière enregistrant le moment où la SEC a accepté le document, heure de l'Est. Issu du champ acceptanceDateTime de la SEC dans l'API de soumissions EDGAR. Fait la paire avec filing_date (précision au jour calendaire du même événement).

        • filing_url
          Type: string | null Format: uri

          URL du document SEC.

        • fiscal_period
          Type: string

          La période fiscale du bilan.

        • form_type
          Type: string | null

          Le formulaire SEC dont provient cette ligne (10-K, 10-Q/A, 20-F, S-1, ...). Le formulaire exact tel que déposé, de sorte que les amendements conservent leur suffixe /A. null lorsque period vaut ttm : une fenêtre de douze mois glissants peut couvrir plusieurs documents, nous ne l'attribuons donc pas à un seul. Une ligne quarterly peut porter 10-K lorsque le quatrième trimestre est dérivé du document de l'exercice fiscal.

        • goodwill_and_intangible_assets
          Type: number

          L'écart d'acquisition et les actifs incorporels de la société.

        • inventory
          Type: number

          Les stocks de la société.

        • investments
          Type: number

          Les investissements de la société.

        • non_current_assets
          Type: number

          Les actifs non courants de la société.

        • non_current_debt
          Type: number

          La dette à long terme de la société.

        • non_current_investments
          Type: number

          Les investissements à long terme de la société.

        • non_current_liabilities
          Type: number

          Le passif non courant de la société.

        • outstanding_shares
          Type: number

          Les actions en circulation de la société.

        • period
          Type: string enum

          La période du bilan.

          valeurs
          • quarterly
          • ttm
          • annual
        • property_plant_and_equipment
          Type: number

          Les immobilisations corporelles de la société.

        • report_period
          Type: string Format: date

          La période de référence du bilan.

        • retained_earnings
          Type: number

          Les bénéfices non distribués de la société.

        • shareholders_equity
          Type: number

          Les capitaux propres de la société.

        • tax_assets
          Type: number

          Les actifs d'impôt de la société.

        • tax_liabilities
          Type: number

          Les passifs d'impôt de la société.

        • ticker
          Type: string

          Le symbole boursier.

        • total_assets
          Type: number

          Le total de l'actif de la société.

        • total_debt
          Type: number

          La dette totale de la société.

        • total_liabilities
          Type: number

          Le total du passif de la société.

        • trade_and_non_trade_payables
          Type: number

          Les dettes fournisseurs et non commerciales de la société.

        • trade_and_non_trade_receivables
          Type: number

          Les créances clients et non commerciales de la société.

      • cash_flow_statements
        Type: array object[] · ResponseE40Feb4D3D6B_CashFlowStatement[]
        • accession_number
          Type: string | null

          Le numéro d'accession SEC du document.

        • business_acquisitions_and_disposals
          Type: number

          Les acquisitions et cessions d'entreprises de la société.

        • capital_expenditure
          Type: number

          Les dépenses d'investissement de la société.

        • change_in_cash_and_equivalents
          Type: number

          La variation de la trésorerie et des équivalents de trésorerie de la société.

        • currency
          Type: string

          La devise dans laquelle les données financières sont présentées.

        • depreciation_and_amortization
          Type: number

          Les amortissements et dépréciations de la société.

        • dividends_and_other_cash_distributions
          Type: number

          Les dividendes et autres distributions en trésorerie de la société.

        • effect_of_exchange_rate_changes
          Type: number

          L'effet des variations des taux de change de la société.

        • ending_cash_balance
          Type: number

          Le solde de trésorerie final de la société.

        • filing_date
          Type: string | null Format: date

          Jour calendaire auquel la SEC a accepté le document, heure de l'Est (fuseau horaire de fonctionnement de la SEC). Paire de jour calendaire avec filing_datetime. null lorsqu'aucun document SEC daté n'est associé à la ligne.

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

          Horodatage à précision infra-journalière enregistrant le moment où la SEC a accepté le document, heure de l'Est. Issu du champ acceptanceDateTime de la SEC dans l'API de soumissions EDGAR. Fait la paire avec filing_date (précision au jour calendaire du même événement).

        • filing_url
          Type: string | null Format: uri

          URL du document SEC.

        • fiscal_period
          Type: string

          La période fiscale du tableau des flux de trésorerie.

        • form_type
          Type: string | null

          Le formulaire SEC dont provient cette ligne (10-K, 10-Q/A, 20-F, S-1, ...). Le formulaire exact tel que déposé, de sorte que les amendements conservent leur suffixe /A. null lorsque period vaut ttm : une fenêtre de douze mois glissants peut couvrir plusieurs documents, nous ne l'attribuons donc pas à un seul. Une ligne quarterly peut porter 10-K lorsque le quatrième trimestre est dérivé du document de l'exercice fiscal.

        • free_cash_flow
          Type: number

          Le flux de trésorerie disponible de la société.

        • investment_acquisitions_and_disposals
          Type: number

          Les acquisitions et cessions de placements de la société.

        • issuance_or_purchase_of_equity_shares
          Type: number

          L'émission ou le rachat d'actions de la société.

        • issuance_or_repayment_of_debt_securities
          Type: number

          L'émission ou le remboursement de titres de créance de la société.

        • net_cash_flow_from_financing
          Type: number

          Le flux de trésorerie net de financement de la société.

        • net_cash_flow_from_investing
          Type: number

          Le flux de trésorerie net d'investissement de la société.

        • net_cash_flow_from_operations
          Type: number

          Le flux de trésorerie net d'exploitation de la société.

        • net_income
          Type: number

          Le résultat net de la société.

        • period
          Type: string enum

          La période du tableau des flux de trésorerie.

          valeurs
          • quarterly
          • ttm
          • annual
        • report_period
          Type: string Format: date

          La période de référence du tableau des flux de trésorerie.

        • share_based_compensation
          Type: number

          La rémunération en actions de la société.

        • ticker
          Type: string

          Le symbole boursier.

      • income_statements
        Type: array object[] · ResponseE40Feb4D3D6B_IncomeStatement[]
        • accession_number
          Type: string | null

          Le numéro d'accession SEC du document.

        • consolidated_income
          Type: number

          Le résultat consolidé de la société.

        • cost_of_revenue
          Type: number

          Le coût des revenus de la société.

        • currency
          Type: string

          La devise dans laquelle les données financières sont présentées.

        • dividends_per_common_share
          Type: number

          Les dividendes par action ordinaire de la société.

        • earnings_per_share
          Type: number

          Le bénéfice par action de la société.

        • earnings_per_share_diluted
          Type: number

          Le bénéfice par action dilué de la société.

        • ebit
          Type: number

          Le bénéfice avant intérêts et impôts de la société.

        • filing_date
          Type: string | null Format: date

          Jour calendaire auquel la SEC a accepté le document, heure de l'Est (fuseau horaire de fonctionnement de la SEC). Paire de jour calendaire avec filing_datetime. null lorsqu'aucun document SEC daté n'est associé à la ligne.

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

          Horodatage à précision infra-journalière enregistrant le moment où la SEC a accepté le document, heure de l'Est. Issu du champ acceptanceDateTime de la SEC dans l'API de soumissions EDGAR. Fait la paire avec filing_date (précision au jour calendaire du même événement).

        • filing_url
          Type: string | null Format: uri

          URL du document SEC.

        • fiscal_period
          Type: string

          La période fiscale du compte de résultat.

        • form_type
          Type: string | null

          Le formulaire SEC dont provient cette ligne (10-K, 10-Q/A, 20-F, S-1, ...). Le formulaire exact tel que déposé, de sorte que les amendements conservent leur suffixe /A. null lorsque period vaut ttm : une fenêtre de douze mois glissants peut couvrir plusieurs documents, nous ne l'attribuons donc pas à un seul. Une ligne quarterly peut porter 10-K lorsque le quatrième trimestre est dérivé du document de l'exercice fiscal.

        • gross_profit
          Type: number

          Le bénéfice brut de la société.

        • income_tax_expense
          Type: number

          Les charges d'impôt sur le résultat de la société.

        • interest_expense
          Type: number

          Les charges d'intérêts de la société.

        • net_income
          Type: number

          Le résultat net de la société.

        • net_income_common_stock
          Type: number

          Le résultat net attribuable aux actionnaires ordinaires de la société.

        • net_income_discontinued_operations
          Type: number

          Le résultat net des activités abandonnées de la société.

        • net_income_non_controlling_interests
          Type: number

          Le résultat net des participations ne donnant pas le contrôle de la société.

        • operating_expense
          Type: number

          Les charges d'exploitation de la société.

        • operating_income
          Type: number

          Le résultat opérationnel de la société.

        • period
          Type: string enum

          La période du compte de résultat.

          valeurs
          • quarterly
          • ttm
          • annual
        • preferred_dividends_impact
          Type: number

          L'impact des dividendes préférentiels sur le résultat net de la société.

        • report_period
          Type: string Format: date

          La période de référence du compte de résultat.

        • research_and_development
          Type: number

          Les charges de recherche et développement de la société.

        • revenue
          Type: number

          Le chiffre d'affaires total de la société.

        • selling_general_and_administrative_expenses
          Type: number

          Les charges de vente, générales et administratives de la société.

        • ticker
          Type: string

          Le symbole boursier.

        • weighted_average_shares
          Type: number

          Le nombre moyen pondéré d'actions de la société.

        • weighted_average_shares_diluted
          Type: number

          Le nombre moyen pondéré dilué d'actions de la société.

    • next_page_url
      Type: string

      URL absolue de la page de résultats suivante. Présente uniquement lorsqu'il reste des résultats ; demandez-la telle quelle pour continuer. Chaque page contient jusqu'à 10 enregistrements.

    application/json
  • 400

    La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.

  • 401

    Une clé API Felo valide est requise.

  • 402

    La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.

  • 403

    Le compte n'est pas autorisé à effectuer cette opération.

  • 429

    Une limite de requêtes ou de dépenses a été atteinte.

  • 502

    Le service n'a pas pu terminer la requête.

  • 503

    L'API ou le service de facturation est temporairement indisponible.

  • 504

    Le service a expiré lors du traitement de la requête.

  • default

    Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

    application/json
Request Example for get/v1/beta/financial/financials
curl 'https://openapi.felo.ai/v1/beta/financial/financials?period=annual' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "financials": {
    "income_statements": [
      {
        "ticker": "string",
        "report_period": "2026-10-26",
        "fiscal_period": "string",
        "period": "quarterly",
        "currency": "string",
        "accession_number": null,
        "form_type": null,
        "filing_url": null,
        "filing_date": null,
        "filing_datetime": null,
        "revenue": 1,
        "cost_of_revenue": 1,
        "gross_profit": 1,
        "operating_expense": 1,
        "selling_general_and_administrative_expenses": 1,
        "research_and_development": 1,
        "operating_income": 1,
        "interest_expense": 1,
        "ebit": 1,
        "income_tax_expense": 1,
        "net_income_discontinued_operations": 1,
        "net_income_non_controlling_interests": 1,
        "net_income": 1,
        "net_income_common_stock": 1,
        "preferred_dividends_impact": 1,
        "consolidated_income": 1,
        "earnings_per_share": 1,
        "earnings_per_share_diluted": 1,
        "dividends_per_common_share": 1,
        "weighted_average_shares": 1,
        "weighted_average_shares_diluted": 1
      }
    ],
    "balance_sheets": [
      {
        "ticker": "string",
        "report_period": "2026-10-26",
        "fiscal_period": "string",
        "period": "quarterly",
        "currency": "string",
        "accession_number": null,
        "form_type": null,
        "filing_url": null,
        "filing_date": null,
        "filing_datetime": null,
        "total_assets": 1,
        "current_assets": 1,
        "cash_and_equivalents": 1,
        "inventory": 1,
        "current_investments": 1,
        "trade_and_non_trade_receivables": 1,
        "non_current_assets": 1,
        "property_plant_and_equipment": 1,
        "goodwill_and_intangible_assets": 1,
        "investments": 1,
        "non_current_investments": 1,
        "outstanding_shares": 1,
        "tax_assets": 1,
        "total_liabilities": 1,
        "current_liabilities": 1,
        "current_debt": 1,
        "trade_and_non_trade_payables": 1,
        "deferred_revenue": 1,
        "deposit_liabilities": 1,
        "non_current_liabilities": 1,
        "non_current_debt": 1,
        "tax_liabilities": 1,
        "shareholders_equity": 1,
        "retained_earnings": 1,
        "accumulated_other_comprehensive_income": 1,
        "total_debt": 1
      }
    ],
    "cash_flow_statements": [
      {
        "ticker": "string",
        "report_period": "2026-10-26",
        "fiscal_period": "string",
        "period": "quarterly",
        "currency": "string",
        "accession_number": null,
        "form_type": null,
        "filing_url": null,
        "filing_date": null,
        "filing_datetime": null,
        "net_income": 1,
        "depreciation_and_amortization": 1,
        "share_based_compensation": 1,
        "net_cash_flow_from_operations": 1,
        "capital_expenditure": 1,
        "business_acquisitions_and_disposals": 1,
        "investment_acquisitions_and_disposals": 1,
        "net_cash_flow_from_investing": 1,
        "issuance_or_repayment_of_debt_securities": 1,
        "issuance_or_purchase_of_equity_shares": 1,
        "dividends_and_other_cash_distributions": 1,
        "net_cash_flow_from_financing": 1,
        "change_in_cash_and_equivalents": 1,
        "effect_of_exchange_rate_changes": 1,
        "ending_cash_balance": 1,
        "free_cash_flow": 1
      }
    ]
  },
  "next_page_url": "string"
}
Get all financial statements