Earnings Report API

OnlineCredit Usage:1 per callRefreshed 1 month ago

avg: 463ms|p50: 438ms|p75: 480ms|p90: 530ms|p99: 630ms

Overview

To use Earnings Report, you need an API key. You can get one by creating a free account and visiting your dashboard.

GET Endpoint

URL

https://api.apiverve.com/v1/earnings

Example

How to call the Earnings Report API in different programming languages.

cURL Request

curl -X GET \
  "https://api.apiverve.com/v1/earnings?ticker=ADBE&year=2024&quarter=2" \
  -H "X-API-Key: your_api_key_here"

JavaScript (Fetch API)

const response = await fetch('https://api.apiverve.com/v1/earnings?ticker=ADBE&year=2024&quarter=2', {
  method: 'GET',
  headers: {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

Python (Requests)

import requests

headers = {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.apiverve.com/v1/earnings?ticker=ADBE&year=2024&quarter=2', headers=headers)

data = response.json()
print(data)

Go (net/http)

package main

import (
    "fmt"
    "io"
    "net/http"

)

func main() {
    req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/earnings?ticker=ADBE&year=2024&quarter=2", nil)

    req.Header.Set("X-API-Key", "your_api_key_here")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

Example Response

{
  "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"
  }
}

Authentication

The Earnings Report API requires authentication via API key. Include your API key in the request header:

Required Header

X-API-Key: your_api_key_here

Learn more about authentication →

Interactive API Playground

Test the Earnings Report API directly in your browser with live requests and responses.

Try Earnings Report APIView details and test in the API marketplace

Parameters

The Earnings Report API supports multiple query options. Use one of the following:

Some Earnings Report parameters marked with Premium are available exclusively on paid plans.View pricing

Option 1: Get Earnings by Ticker

Parameter	Type	Required	Description	Default	Example
`ticker`	string	`required`	Stock ticker symbol (e.g. AAPL, MSFT, ADBE) Length: `1 - 5 chars`	-	`ADBE`
`year`Premium	integer	`optional`	Fiscal year to retrieve. Defaults to latest available. Range: `2000 - 2030`	-	`2024`
`quarter`Premium	integer	`optional`	Fiscal quarter to retrieve. Defaults to latest available. Range: `1 - 4`	-	`2`

Option 2: Get Earnings by CIK

Parameter	Type	Required	Description	Default	Example
`cik`	string	`required`	SEC CIK number (e.g. 796343 or 0000796343)	-	`796343`
`year`Premium	integer	`optional`	Fiscal year to retrieve. Defaults to latest available. Range: `2000 - 2030`	-	`2024`
`quarter`Premium	integer	`optional`	Fiscal quarter to retrieve. Defaults to latest available. Range: `1 - 4`	-	`2`

Response

The Earnings Report API returns responses in JSON, XML, YAML, and CSV formats. The JSON response is shown in the Example section above; alternative formats below.

Other Response Formats

XML Response

200 OK

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

YAML Response

200 OK

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'

CSV Response

200 OK

key	value
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

View in Marketplace

Response Structure

All API responses follow a consistent structure with the following fields:

Field	Type	Description	Example
`status`	string	Indicates whether the request was successful ("ok") or failed ("error")	`ok`
`error`	string \| null	Contains error message if status is "error", otherwise null	`null`
`data`	object \| null	Contains the API response data if successful, otherwise null	`{...}`

Learn more about response formats →

Response Data Fields

When the request is successful, the data object contains the following fields:

Response fields marked with Premium are available exclusively on paid plans.View pricing

Field	Type	Sample Value	Description
`ticker`	string	`"ADBE"`	Stock ticker symbol for the company
`company`	string	`"ADOBE INC."`	Official registered name of the company
`cik`	string	`"0000796343"`	SEC Central Index Key unique identifier
`fiscalYear`	number	`2025`	Fiscal year of the reporting period
`fiscalQuarter`	number	`2`	Fiscal quarter number (1-4)
`filingType`Premium	string	`"10-Q"`	SEC filing type (10-Q, 10-K, etc.)
`filingDate`	string	`"2025-06-25"`	Date when SEC filing was submitted
`periodEnd`	string	`"2025-05-30"`	End date of the reporting period
`income`	object	`{...}`	-
└ `revenue`Premium	number	`11587000000`	Total revenue in dollars (derived total)
└ `costOfRevenue`	number	`1260000000`	Direct costs of producing goods sold
└ `grossProfit`	number	`10327000000`	Gross profit calculated from revenue
└ `operatingIncome`	number	`4272000000`	Income from normal business operations
└ `netIncome`Premium	number	`3502000000`	Bottom-line profit after all expenses
└ `eps`Premium	number	`8.08`	Earnings per share (diluted)
└ `epsBasic`	number	`8.1`	Basic earnings per share calculation
└ `sharesOutstanding`Premium	number	`433000000`	Diluted shares outstanding (in millions)
└ `sharesOutstandingBasic`	number	`432000000`	Basic shares outstanding (in millions)
└ `researchAndDevelopment`	number	`2108000000`	Research and development expenses
└ `sellingAndMarketing`	number	`3121000000`	Sales and marketing operational expenses

Headers

Only X-API-Key is required. Optional headers include Accept for response format negotiation (JSON, XML, or YAML), User-Agent, and X-Request-ID for request tracing. See all request headers →

GraphQL AccessALPHA

Access Earnings Report through GraphQL to combine it with other API calls in a single request. Query only the earnings report data you need with precise field selection, and orchestrate complex data fetching workflows.

Test Earnings Report in the GraphQL Explorer to confirm availability and experiment with queries.

Credit Cost: Each API called in your GraphQL query consumes its standard credit cost.

GraphQL Endpoint

POST https://api.apiverve.com/v1/graphql

GraphQL Query Example

query {
  earnings(
    input: {
      ticker: "ADBE"
      year: 2024
      quarter: 2
    }
  ) {
    ticker
    company
    cik
    fiscalYear
    fiscalQuarter
    filingType
    filingDate
    periodEnd
    income {
      revenue
      costOfRevenue
      grossProfit
      operatingIncome
      netIncome
      eps
      epsBasic
      sharesOutstanding
      sharesOutstandingBasic
      researchAndDevelopment
      sellingAndMarketing
      sellingGeneralAndAdmin
      generalAndAdmin
      interestExpense
      incomeTax
      depreciation
      stockBasedCompensation
    }
    balance {
      totalAssets
      currentAssets
      cash
      receivables
      inventory
      propertyAndEquipment
      goodwill
      intangibles
      totalLiabilities
      currentLiabilities
      accountsPayable
      longTermDebt
      equity
      retainedEarnings
    }
    cashFlow {
      operatingCashFlow
      capitalExpenditures
      freeCashFlow
      investingCashFlow
      financingCashFlow
      dividendsPaid
      shareRepurchases
    }
    metrics {
      grossMargin
      operatingMargin
      netMargin
      revenueFormatted
    }
    lastUpdated
  }
}

Note: Authentication is handled via the x-api-key header in your GraphQL request, not as a query parameter.

Try in GraphQL Explorer GraphQL Documentation

CORS Support

The Earnings Report API accepts cross-origin requests from any origin, so it can be called directly from browser-based applications without a proxy. See CORS support →

Rate Limiting

Earnings Report requests are throttled per minute on the Free plan and unthrottled on paid plans. Exceeding the limit returns 429 Too Many Requests; rate-limit usage is reported in the X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset response headers. See per-plan limits and best practices →

Error Codes

The Earnings Report API uses standard HTTP status codes — 200 on success, 400 for invalid parameters, 401 for missing or invalid keys, 403 for insufficient credits, 429 for rate-limit exhaustion, and 500/503 for server-side issues. Each error response includes an X-Request-ID header you can quote when contacting support. See full error handling guide →

SDKs for Earnings Report

Official Earnings Report packages on npm, PyPI, NuGet, and JitPack — plus a Postman collection and an OpenAPI spec. See the SDK guide →

JitPack

No-Code Integrations

Earnings Report works with Zapier, Make, Pipedream, n8n, and Power Automate using the same API key. See setup guides →

Zapier

Make

Pipedream

n8n

Power Automate

Frequently Asked Questions

How do I get an API key for Earnings Report?

Sign up for a free account at dashboard.apiverve.com. Your API key will be automatically generated and available in your dashboard. The same key works for Earnings Report and all other APIVerve APIs. The free plan includes 1,000 credits plus a 500 credit bonus.

How many credits does Earnings Report cost?

Each successful Earnings Report API call consumes credits based on plan tier. Check the pricing section above for the exact credit cost. Failed requests and errors don't consume credits, so you only pay for successful earnings report lookups.

Can I use Earnings Report in production?

The free plan is for testing and development only. For production use of Earnings Report, upgrade to a paid plan (Starter, Pro, or Mega) which includes commercial use rights, no attribution requirements, and guaranteed uptime SLAs. All paid plans are production-ready.

Can I use Earnings Report from a browser?

Yes! The Earnings Report API supports CORS with wildcard configuration, so you can call it directly from browser-based JavaScript without needing a proxy server. See the CORS section above for details.

What happens if I exceed my Earnings Report credit limit?

When you reach your monthly credit limit, Earnings Report API requests will return an error until you upgrade your plan or wait for the next billing cycle. You'll receive notifications at 80% and 95% usage to give you time to upgrade if needed.

What's Next?

Continue your journey with these recommended resources

Browse All APIs

Explore our complete catalog of APIs

Authentication Guide

Learn about API keys and security

Rate Limits

Understand usage limits and best practices

Was this page helpful?

Earnings Report API

Overview

GET Endpoint

Example

Authentication

Interactive API Playground

Parameters

Option 1: Get Earnings by Ticker

Option 2: Get Earnings by CIK

Response

Other Response Formats

Response Structure

Response Data Fields

Headers

GraphQL AccessALPHA

CORS Support

Rate Limiting

Error Codes

SDKs for Earnings Report

No-Code Integrations

Frequently Asked Questions

People who used this also used...

VAT Rates

Unemployment Rate

Treasury Yields

What's Next?

Browse All APIs

Authentication Guide

Rate Limits