Skip to content

apiverve/earnings-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

263 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Earnings Report is a tool for retrieving company financial data including income statement, balance sheet, and cash flow data from SEC filings. It supports lookup by ticker or CIK with optional year and quarter filters.

The Earnings Report API provides a simple, reliable way to integrate earnings report functionality into your applications. Built for developers who need production-ready earnings report capabilities without the complexity of building from scratch.

View API Details β†’

License: MIT API Status Method Platform

Available on: npm NuGet PyPI RubyGems Packagist Go Dart JitPack


Quick Start

Using JavaScript

async function callEarningsReportAPI() {
    try {
        const params = new URLSearchParams({
            ticker: 'ADBE'
        });

        const response = await fetch(`https://api.apiverve.com/v1/earnings?${params}`, {
            method: 'GET',
            headers: {
                'x-api-key': 'YOUR_API_KEY_HERE'
            }
        });

        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callEarningsReportAPI();

Using cURL

curl -X GET "https://api.apiverve.com/v1/earnings?ticker=ADBE" \
  -H "x-api-key: YOUR_API_KEY_HERE"

Get your API key: https://apiverve.com

πŸ“ For more examples, see the examples folder


Installation

Choose your preferred programming language:

πŸ“¦ NPM (JavaScript/Node.js)

npm install @apiverve/earnings

View NPM Package β†’ | Package Code β†’


πŸ”· NuGet (.NET/C#)

dotnet add package APIVerve.API.EarningsReport

View NuGet Package β†’ | Package Code β†’


🐍 Python (PyPI)

pip install apiverve-earnings

View PyPI Package β†’ | Package Code β†’


πŸ’Ž Ruby (RubyGems)

gem install apiverve_earnings

View RubyGems Package β†’ | Package Code β†’


🐘 PHP (Packagist)

composer require apiverve/earnings

View Packagist Package β†’ | Package Code β†’


🎯 Dart (pub.dev)

dart pub add apiverve_earnings

View pub.dev Package β†’ | Package Code β†’


πŸ€– Android (JitPack)

implementation 'com.github.apiverve:earnings-api:1.0.0'

Package Code β†’


🐹 Go

go get github.com/apiverve/earnings-api/go

Package Code β†’


Why Use This API?

Feature Benefit
Multi-language SDKs Native packages for JavaScript, Python, C#, Go, and Android
Simple Integration Single API key authentication, consistent response format
Production Ready 99.9% uptime SLA, served from 24 global regions
Comprehensive Docs Full examples, OpenAPI spec, and dedicated support

Documentation


What Can You Build?

The Earnings Report API is commonly used for:

  • Web Applications - Add earnings report features to your frontend or backend
  • Mobile Apps - Native SDKs for Android development
  • Automation - Integrate with n8n, Zapier, or custom workflows
  • SaaS Products - Enhance your product with earnings report capabilities
  • Data Pipelines - Process and analyze data at scale

API Reference

Authentication

All requests require an API key in the header:

x-api-key: YOUR_API_KEY_HERE

Get your API key: https://apiverve.com

Response Format

Every APIVerve endpoint returns the same envelope β€” check status, then read data:

{
  "status": "ok",
  "error": null,
  "data": { ... }
}

Example Response

A real response from the Earnings Report API:

{
  "status": "ok",
  "error": null,
  "data": {
    "ticker": "ADBE",
    "company": "ADOBE INC.",
    "cik": "0000796343",
    "fiscalYear": 2025,
    "fiscalQuarter": 2,
    "filingType": "10-Q",
    "filingDate": "2025-06-25",
    "periodEnd": "2025-05-30",
    "income": {
      "revenue": 11587000000,
      "costOfRevenue": 1260000000,
      "grossProfit": 10327000000,
      "operatingIncome": 4272000000,
      "netIncome": 3502000000,
      "eps": 8.08,
      "epsBasic": 8.1,
      "sharesOutstanding": 433000000,
      "sharesOutstandingBasic": 432000000,
      "researchAndDevelopment": 2108000000,
      "sellingAndMarketing": 3121000000,
      "sellingGeneralAndAdmin": null,
      "generalAndAdmin": 744000000,
      "interestExpense": 68000000,
      "incomeTax": 781000000,
      "depreciation": 82000000,
      "stockBasedCompensation": null
    },
    "balance": {
      "totalAssets": 28107000000,
      "currentAssets": 8978000000,
      "cash": 4931000000,
      "receivables": 1735000000,
      "inventory": null,
      "propertyAndEquipment": 1890000000,
      "goodwill": 12830000000,
      "intangibles": 631000000,
      "totalLiabilities": 16659000000,
      "currentLiabilities": 9039000000,
      "accountsPayable": 360000000,
      "longTermDebt": 6166000000,
      "equity": 11448000000,
      "retainedEarnings": 41744000000
    },
    "cashFlow": {
      "operatingCashFlow": 4673000000,
      "capitalExpenditures": 73000000,
      "freeCashFlow": 4600000000,
      "investingCashFlow": -762000000,
      "financingCashFlow": -6629000000,
      "dividendsPaid": null,
      "shareRepurchases": 6750000000
    },
    "metrics": {
      "grossMargin": 89.12,
      "operatingMargin": 36.87,
      "netMargin": 30.22,
      "revenueFormatted": "$11.59B"
    },
    "lastUpdated": "2026-02-05T08:00:00.000Z"
  }
}

Support & Community


Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.


Security

For security concerns, please review our Security Policy.


License

This project is licensed under the MIT License - see the LICENSE file for details.


Acknowledgments

Built with ❀️ by APIVerve

Copyright Β© 2026 APIVerve. All rights reserved.

About

Earnings Report is a tool for retrieving company financial data including income statement, balance sheet, and cash flow data from SEC filings. It supports lookup by ticker or CIK with optional year and quarter filters.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages