apiverve / earnings
Earnings Report returns a company's complete financial statements - income statement, balance sheet and cash flow together - in a single call from SEC filings, making it a one-stop earnings API for fundamental stock data. Look up by ticker or CIK; paid plans add calculated margins and year and quart
Requires
- php: >=7.4
- guzzlehttp/guzzle: ^7.0
Requires (Dev)
- phpunit/phpunit: ^9.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Earnings Report returns a company's complete financial statements - income statement, balance sheet and cash flow together - in a single call from SEC filings, making it a one-stop earnings API for fundamental stock data. Look up by ticker or CIK; paid plans add calculated margins and year and quarter filters. For a single focused statement, see the Income Statement, Balance Sheet, Cash Flow and Financial Ratios APIs.
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.
Available on:
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'
🐹 Go
go get github.com/apiverve/earnings-api/go
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
- 🏠 API Home: Earnings Report API
- 📚 API Reference: docs.apiverve.com/ref/earnings
- 📖 OpenAPI Spec: openapi.yaml
- 💡 Examples: examples/
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": 2026,
"fiscalQuarter": 2,
"filingType": "10-Q",
"filingDate": "2026-06-15",
"periodEnd": "2026-05-29",
"income": {
"revenue": 6618000000,
"costOfRevenue": 715000000,
"grossProfit": 5903000000,
"operatingIncome": 2238000000,
"netIncome": 1712000000,
"eps": 4.25,
"epsBasic": 4.26,
"sharesOutstanding": 402500000,
"sharesOutstandingBasic": 402400000,
"researchAndDevelopment": null,
"sellingAndMarketing": 1884000000,
"sellingGeneralAndAdmin": null,
"generalAndAdmin": 546000000,
"interestExpense": null,
"incomeTax": 526000000,
"depreciation": 367000000,
"stockBasedCompensation": 1043000000
},
"balance": {
"totalAssets": 29933000000,
"currentAssets": 9068000000,
"cash": 4919000000,
"receivables": 1993000000,
"inventory": null,
"propertyAndEquipment": 1870000000,
"goodwill": 14041000000,
"intangibles": 1012000000,
"totalLiabilities": 18415000000,
"currentLiabilities": 12078000000,
"accountsPayable": 499000000,
"longTermDebt": 4802000000,
"equity": 11518000000,
"retainedEarnings": 48767000000
},
"cashFlow": {
"operatingCashFlow": 5123000000,
"capitalExpenditures": 95000000,
"freeCashFlow": 5028000000,
"investingCashFlow": -1240000000,
"financingCashFlow": -4399000000,
"dividendsPaid": null,
"shareRepurchases": 4589000000
},
"dividends": null,
"lastUpdated": "2026-07-17T23:01:47.364Z",
"metrics": {
"grossMargin": 89.2,
"operatingMargin": 33.82,
"netMargin": 25.87,
"revenueFormatted": "$6.62B"
}
}
}
Support & Community
- 🏠 API Home: Earnings Report API
- 💬 Support: https://apiverve.com/contact
- 🐛 Issues: GitHub Issues
- 📖 Documentation: https://docs.apiverve.com
- 🌐 Website: https://apiverve.com
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.