First Result

Make one request, get a real response, then build from there.

Get your API key

Your API key is automatically created when you sign up.

Copy & paste this

Fetch an earnings calendar for a date.

GET https://api.earningsapi.com/v1/calendar/earnings?date=2025-07-02&apikey=YOUR_API_KEY

If you are not signed in, replace YOUR_API_KEY.

You should see JSON like this

{
  "date": "2025-07-02",
  "pre": [
    {
      "symbol": "JPM",
      "name": "J P Morgan Chase & Co",
      "epsEstimate": "$5.01",
      "eps": "$4.81",
      "revenue": 45798000000,
      "revenueEstimate": 46166454906
    }
  ],
  "after": [
    {
      "symbol": "DAL",
      "name": "Delta Air Lines, Inc.",
      "epsEstimate": "$1.53",
      "eps": "$1.85",
      "revenue": 16003000000,
      "revenueEstimate": 14682059858
    }
  ],
  "notSupplied": [
    {
      "symbol": "BK",
      "name": "The Bank Of New York Mellon Corporation ",
      "epsEstimate": "$1.97",
      "eps": "$1.72",
      "revenue": 8869000000,
      "revenueEstimate": 5141942072
    }
  ]
}

Your API Key

If you’re signed in, you can copy your key and use it in requests immediately.

Most Used (Copy & Paste)

These are the most common request patterns. Start here before diving into full reference.

Earnings for a date

Get companies reporting earnings before open, after close, and unspecified times.

GET https://api.earningsapi.com/v1/calendar/earnings?date=2025-07-02&apikey=YOUR_API_KEY

{
  "date": "2025-07-02",
  "pre": [...],
  "after": [...],
  "notSupplied": [...]
}

See full fields and examples in Calendar reference.

Authentication

Authenticate by adding apikey as a query parameter.

If there are no existing query params:?apikey=YOUR_API_KEY

If there are already query params:&apikey=YOUR_API_KEY

Common mistake (incorrect):...?page=1?apikey=...

https://api.earningsapi.com/v1/summaries?page=1&apikey=YOUR_API_KEY

Earnings Calendar

Retrieve earnings calendar for a specific date.

Get Earnings Calendar

GET/v1/calendar/earnings

Returns earnings schedules for a specific date.

Query Parameters

Parameter	Type	Required	Description
`date`	string	Yes	Date in YYYY-MM-DD format (e.g., "2026-01-31")

Example Request

GET https://api.earningsapi.com/v1/calendar/earnings?date=2026-01-31&apikey=YOUR_API_KEY

Response Example

{
  "date": "2025-07-02",
  "pre": [
    {
      "symbol": "JPM",
      "name": "J P Morgan Chase & Co",
      "epsEstimate": "$5.01",
      "eps": "$4.81",
      "revenue": 45798000000,
      "revenueEstimate": 46166454906
    }
  ],
  "after": [
    {
      "symbol": "DAL",
      "name": "Delta Air Lines, Inc.",
      "epsEstimate": "$1.53",
      "eps": "$1.85",
      "revenue": 16003000000,
      "revenueEstimate": 14682059858
    }
  ],
  "notSupplied": [
    {
      "symbol": "BK",
      "name": "The Bank Of New York Mellon Corporation ",
      "epsEstimate": "$1.97",
      "eps": "$1.72",
      "revenue": 8869000000,
      "revenueEstimate": 5141942072
    }
  ]
}

Response Fields

Field	Type	Description
`date`	string	Date in YYYY-MM-DD format
`pre`	array	Companies reporting before market open
`after`	array	Companies reporting after market close
`notSupplied`	array	Companies with unspecified reporting times

Schedule Object Fields

Field	Type	Description
`symbol`	string	Stock ticker symbol (e.g., "JPM", "AAPL")
`name`	string	Company name
`epsEstimate`	string	Estimated earnings per share (e.g., "$5.01" or empty string)
`eps`	string	Actual earnings per share (e.g., "$4.81" or empty string if not reported)
`revenue`	number	Actual revenue in dollars (e.g., 45798000000) or null if not reported
`revenueEstimate`	number	Estimated revenue in dollars (e.g., 46166454906) or null if not available

🗓️ Calendar Deep Dive

Advanced examples and use cases for Calendar.

View Details →

Economic Calendar

Retrieve economic events for a specific date. Time is Eastern Time (ET).

Get Economic Calendar

GET/v1/calendar/economic

Returns economic events for a given date. Time is Eastern Time (ET). Some events may use 24H.

Query Parameters

Parameter	Type	Required	Description
`date`	string	Yes	Date in YYYY-MM-DD format (e.g., "2026-01-31")
`usmajor`	boolean	No	If true, returns U.S. major indicators only (default: false)

Example Request

GET https://api.earningsapi.com/v1/calendar/economic?date=2026-01-31&usmajor=true&apikey=YOUR_API_KEY

Response Example

[
  {
    "country": "United States",
    "eventName": "PPI",
    "date": "2026-01-31",
    "time": "08:30",
    "actual": null,
    "consensus": "0.2%",
    "previous": "0.2%"
  },
  {
    "country": "United States",
    "eventName": "Core PPI",
    "date": "2026-01-31",
    "time": "08:30",
    "actual": null,
    "consensus": "0.3%",
    "previous": "0.0%"
  },
  {
    "country": "Japan",
    "eventName": "Housing Starts",
    "date": "2026-01-31",
    "time": "24H",
    "actual": null,
    "consensus": "-4.5%",
    "previous": "-8.5%"
  }
]

Response Fields

Field	Type	Description
`country`	string	Country or region name
`eventName`	string	Event name (e.g., "PPI")
`date`	string	Event date in YYYY-MM-DD format
`time`	string	Time in ET (e.g., "08:30") or "24H"
`actual`	string \| null	Actual value (null if not released yet)
`consensus`	string \| null	Market consensus/forecast (may be null)
`previous`	string \| null	Previous value (may be null)

🌐 Economic Calendar Deep Dive

Advanced examples and use cases for Economic Calendar.

View Details →

IPO Calendar

Retrieve upcoming IPO schedules. This endpoint always returns future IPOs only.

Get Upcoming IPOs

GET/v1/calendar/ipo

Returns upcoming IPO events automatically. No date or filter parameters are required or supported.

⚡ This endpoint always returns upcoming IPOs only. Past IPOs are not included.

Example Request

GET https://api.earningsapi.com/v1/calendar/ipo?apikey=YOUR_API_KEY

Response Example

[
  {
    "symbol": "LEGOU",
    "companyName": "Legato Merger Corp. IV",
    "date": "2026-01-23"
  },
  {
    "symbol": "XSLLU",
    "companyName": "Xsolla SPAC 1",
    "date": "2026-01-23"
  },
  {
    "symbol": "GIXXU",
    "companyName": "GigCapital9 Corp.",
    "date": "2026-01-27"
  }
]

Response Fields

Field	Type	Description
`symbol`	string	IPO ticker symbol
`companyName`	string	Company name
`date`	string	IPO date (YYYY-MM-DD)

🚀 IPO Calendar Deep Dive

Advanced examples and use cases for IPO Calendar.

View Details →

Dividends Calendar

Retrieve upcoming dividend events (ex-dividend date, payment date, and dividend rate). This endpoint always returns future dividend events only.

Get Upcoming Dividends

GET/v1/calendar/dividends

Returns upcoming dividend events automatically. No date or filter parameters are required or supported.

⚡ This endpoint always returns upcoming dividends only. Past dividend events are not included.

Example Request

GET https://api.earningsapi.com/v1/calendar/dividends?apikey=YOUR_API_KEY

Response Example

[
  {
    "name": "Diversified Healthcare Trust Common Shares of Beneficial Interest",
    "symbol": "DHC",
    "dividend_ex_date": "2026-01-26",
    "payment_date": "2026-02-19",
    "dividend_rate": 0.01
  },
  {
    "name": "Paychex, Inc. Common Stock",
    "symbol": "PAYX",
    "dividend_ex_date": "2026-01-28",
    "payment_date": "2026-02-27",
    "dividend_rate": 1.08
  },
  {
    "name": "Texas Instruments Incorporated Common Stock",
    "symbol": "TXN",
    "dividend_ex_date": "2026-01-30",
    "payment_date": "2026-02-10",
    "dividend_rate": 1.42
  }
]

Response Fields

Field	Type	Description
`name`	string	Company / security name
`symbol`	string	Ticker symbol
`dividend_ex_date`	string	Ex-dividend date (YYYY-MM-DD)
`payment_date`	string	Payment date (YYYY-MM-DD)
`dividend_rate`	number	Dividend amount (per share)

💸 Dividends Calendar Deep Dive

Advanced examples and use cases for Dividends Calendar.

View Details →

Company Earnings

Retrieve historical and upcoming earnings data for a specific symbol.

Get Earnings Data

GET/v1/earnings

Returns a list of earnings events for the specified symbol.

Query Parameters

Parameter	Type	Required	Description
`symbol`	string	Yes	Stock ticker symbol (e.g., "AAPL")

Example Request

GET https://api.earningsapi.com/v1/earnings?symbol=AAPL&apikey=YOUR_API_KEY

Response Example

[
  {
    "date": "2026-04-26",
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "time": null,
    "epsEstimate": null,
    "eps": null,
    "revenue": null,
    "revenueEstimate": null
  },
  {
    "date": "2026-01-29",
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "time": "time-after-hours",
    "epsEstimate": "$2.65",
    "eps": null,
    "revenue": null,
    "revenueEstimate": null
  },
  {
    "date": "2025-10-30",
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "time": "time-after-hours",
    "epsEstimate": "$1.73",
    "eps": "$1.85",
    "revenue": 102466000000,
    "revenueEstimate": 102227074560
  },
  ...
]

Response Fields

Field	Type	Description
`date`	string	Earnings date in YYYY-MM-DD format
`symbol`	string	Stock ticker symbol (e.g., "AAPL")
`name`	string	Company name
`time`	string	Reporting time (e.g., "time-after-hours", "time-pre-market") or null if not available
`epsEstimate`	string	Estimated EPS (e.g., "$1.73") or null if not available
`eps`	string	Actual EPS (e.g., "$1.85") or null if not reported
`revenue`	number	Actual revenue in dollars or null if not reported
`revenueEstimate`	number	Estimated revenue in dollars or null if not available

💎 Earnings Deep Dive

Advanced examples and use cases for Earnings.

View Details →

Earnings Reactions

Retrieve earnings results (EPS/revenue beat or miss) and post-earnings price/volume reactions for a symbol.

Get Earnings Reactions

GET/v1/earnings-reactions

Returns earnings events with surprise metrics (surprisePercent, yoy, beat) and daily price/volume reactions after each report.

Query Parameters

Parameter	Type	Required	Description
`symbol`	string	Yes	Stock ticker symbol (e.g., "AAPL")

Example Request

GET https://api.earningsapi.com/v1/earnings-reactions?symbol=AAPL&apikey=YOUR_API_KEY

Response Example

[
  {
    "date": "2026-01-29",
    "symbol": "AAPL",
    "eps": {
      "surprisePercent": 7.16981132075472,
      "yoy": 18.3333333333333,
      "beat": true
    },
    "revenue": {
      "surprisePercent": 3.87669148773973,
      "yoy": 15.6524537409493,
      "beat": true
    },
    "reactions": [
      {
        "date": "2026-01-30",
        "priceChange": 0.464612048939153,
        "volume": 92443408,
        "open": 255.17,
        "close": 259.48,
        "high": 261.9,
        "low": 252.18
      },
      {
        "date": "2026-02-02",
        "priceChange": 4.05811623246492,
        "volume": 73913425,
        "open": 260.03,
        "close": 270.01,
        "high": 270.49,
        "low": 259.21
      }
    ]
  }
]

Response Fields

Field	Type	Description
`date`	string	Earnings report date (YYYY-MM-DD)
`symbol`	string	Stock ticker symbol
`eps`	object	EPS metrics: surprisePercent, yoy (year-over-year %), beat (true/false)
`revenue`	object	Revenue metrics: surprisePercent, yoy (year-over-year %), beat (true/false)
`reactions`	array	Daily price/volume data after the report: date, priceChange (%), volume, open, close, high, low

🎢 Earnings Reactions Deep Dive

Use earnings surprise and post-earnings price reactions for backtesting or analysis.

View Details →

Profile

Retrieve company profile (symbol, name, CIK, exchange, sector, type, tags).

Get Company Profile

GET/v1/profile/{symbol}

Returns profile data for the specified symbol (type, sector, exchange, tags, etc.).

Path Parameters

Parameter	Type	Required	Description
`symbol`	string	Yes	Stock ticker symbol in path (e.g., AAPL → /v1/profile/AAPL)

Example Request

GET https://api.earningsapi.com/v1/profile/AAPL?apikey=YOUR_API_KEY

Response Example

{
  "symbol": "AAPL",
  "companyName": "Apple Inc.",
  "cik": "0000320193",
  "exchange": "NASDAQ",
  "sector": "Technology",
  "type": "equity",
  "tags": []
}

Response Fields

Field	Type	Description
`symbol`	string	Stock ticker symbol
`companyName`	string	Company name
`cik`	string	SEC Central Index Key (CIK)
`exchange`	string	Primary exchange (e.g., NASDAQ, NYSE)
`sector`	string	Sector (e.g., Technology)
`type`	string	One of: equity, fund, non_equity, other
`tags`	array	Optional tags: adr, etf, etn, reit, preferred, warrant, right, unit, spac

🧑‍💼 Profile Deep Dive

Advanced examples and use cases for Profile.

View Details →

Income Statement

Retrieve company income statement (revenue, costs, operating income, net income, EPS, etc.) by symbol.

Get Income Statement

GET/v1/income-statement

Returns an array of income statement periods for the specified symbol (revenue, gross profit, operating income, net income, EPS, shares, etc.).

⚡ When data for a field is not available, the API returns null instead of 0.

Query Parameters

Parameter	Type	Required	Description
`symbol`	string	Yes	Stock ticker symbol (e.g., AAPL)

Example Request

GET https://api.earningsapi.com/v1/income-statement?symbol=AAPL&apikey=YOUR_API_KEY

Response Example

[
  {
    "symbol": "AAPL",
    "date": "2025-12-27",
    "fiscalYear": 2026,
    "period": "Q1",
    "filed": "2026-01-30",
    "reportedCurrency": "USD",
    "revenue": 143756000000,
    "costOfRevenue": 74525000000,
    "grossProfit": 69231000000,
    "researchAndDevelopmentExpense": 10887000000,
    "sellingGeneralAndAdministrativeExpense": 7492000000,
    "sellingAndMarketingExpense": 5397000000,
    "generalAndAdministrativeExpense": 2095000000,
    "operatingExpenses": 18379000000,
    "costsAndExpenses": 92904000000,
    "operatingIncome": 50852000000,
    "interestExpense": null,
    "incomeBeforeTax": 51002000000,
    "incomeTaxExpense": 8905000000,
    "netIncome": 42097000000,
    "eps": 2.85,
    "epsDiluted": 2.84,
    "weightedAverageSharesBasic": 14748158000,
    "weightedAverageSharesDiluted": 14810356000
  }
]

Response Fields

Field	Type	Description
`symbol`	string	Stock ticker symbol
`date`	string	Period end date (YYYY-MM-DD)
`fiscalYear`	number	Fiscal year
`period`	string	Fiscal period (e.g., Q1, Q2, FY)
`filed`	string	Filing date (YYYY-MM-DD)
`reportedCurrency`	string	Reporting currency (e.g., USD)
`revenue`	number	Total revenue
`costOfRevenue`	number	Cost of revenue
`grossProfit`	number	Gross profit
`researchAndDevelopmentExpense`	number	R&D expense
`sellingGeneralAndAdministrativeExpense`	number	SG&A expense
`operatingExpenses`	number	Total operating expenses
`operatingIncome`	number	Operating income
`incomeBeforeTax`	number	Income before tax
`incomeTaxExpense`	number	Income tax expense
`netIncome`	number	Net income
`eps`	number	Earnings per share (basic)
`epsDiluted`	number	Earnings per share (diluted)
`weightedAverageSharesBasic`	number	Weighted average shares (basic)
`weightedAverageSharesDiluted`	number	Weighted average shares (diluted)

📑 Income Statement Deep Dive

Advanced examples and use cases for Income Statement.

View Details →

Market Caps

Retrieve real-time market capitalization rankings and data.

Get Market Caps

GET/v1/marketcaps

Returns a list of companies ranked by market capitalization. Limited to top 100 companies.

Example Request

GET https://api.earningsapi.com/v1/marketcaps?apikey=YOUR_API_KEY

Response Example

[
  {
    "rank": 1,
    "symbol": "NVDA",
    "name": "NVIDIA",
    "marketCap": 4327101000000,
    "pctchange": -4.382,
    "prevRank": 1,
    "rankChange": 0
  },
  {
    "rank": 2,
    "symbol": "GOOG",
    "name": "Alphabet",
    "marketCap": 3887504720000,
    "pctchange": -2.476,
    "prevRank": 2,
    "rankChange": 0
  },
  {
    "rank": 3,
    "symbol": "AAPL",
    "name": "Apple",
    "marketCap": 3625978344200,
    "pctchange": -3.456,
    "prevRank": 3,
    "rankChange": 0
  },
  ...
]

Response Fields

Field	Type	Description
`rank`	number	Current rank by market cap
`symbol`	string	Stock ticker symbol
`name`	string	Company name
`marketCap`	number	Market capitalization in USD
`pctchange`	number	Percentage change (e.g. -4.382)
`prevRank`	number	Previous rank (one week ago)
`rankChange`	number	Change in rank (e.g. 0, 1, -1)

📊 Market Caps Deep Dive

Advanced examples and use cases for Market Caps.

View Details →

Market Status

Check if the U.S. market is open right now, plus today/tomorrow flags and the next open date.

Get Market Status

GET/v1/market-status

Returns the current market session state and basic today/tomorrow open signals.

Example Request

GET https://api.earningsapi.com/v1/market-status?apikey=YOUR_API_KEY

Response Example

{
  "isTodayOpen": true,
  "isTomorrowOpen": true,
  "nextOpenDate": "2026-01-27",
  "currentMarketStatus": "closed"
}

Response Fields

Field	Type	Description
`isTodayOpen`	boolean	Whether the market is open at any point today
`isTomorrowOpen`	boolean	Whether the market is open at any point tomorrow
`nextOpenDate`	string	Next open date in YYYY-MM-DD format
`currentMarketStatus`	string	One of: pre-market, open, after-hours, closed

🟢 Market Status Deep Dive

Advanced examples and use cases for Market Status.

View Details →

Market Holidays

Retrieve the official market holiday schedule (including early close days).

Get Market Holidays

GET/v1/market-holidays

Returns an array of holiday objects. Some dates may have early close status (e.g., 13:00 ET).

Example Request

GET https://api.earningsapi.com/v1/market-holidays?apikey=YOUR_API_KEY

Response Example

[
  { "name": "New Year's Day", "date": "2026-01-01", "status": "closed" },
  { "name": "MLK, Jr. Day", "date": "2026-01-19", "status": "closed" },
  { "name": "Presidents Day", "date": "2026-02-16", "status": "closed" },
  { "name": "Good Friday", "date": "2026-04-03", "status": "closed" },
  { "name": "Memorial Day", "date": "2026-05-25", "status": "closed" },
  { "name": "Juneteenth", "date": "2026-06-19", "status": "closed" },
  { "name": "Independence Day (Observed)", "date": "2026-07-03", "status": "closed" },
  { "name": "Labor Day", "date": "2026-09-07", "status": "closed" },
  { "name": "Thanksgiving Day", "date": "2026-11-26", "status": "closed" },
  { "name": "Day after Thanksgiving", "date": "2026-11-27", "status": "early_close(13:00)" },
  { "name": "Christmas Eve", "date": "2026-12-24", "status": "early_close(13:00)" },
  { "name": "Christmas Day", "date": "2026-12-25", "status": "closed" }
]

Response Fields

Field	Type	Description
`name`	string	Holiday name (may include "Observed")
`date`	string	Date in YYYY-MM-DD format
`status`	string	"closed" or "early_close(13:00)"

🎊 Market Holidays Deep Dive

Advanced examples and use cases for Market Holidays.

View Details →

Earnings Summaries

Browse AI-generated summaries of earnings press releases.

List All Summaries

GET/v1/summaries

Retrieve a list of summaries with optional filtering.

Query Parameters

Parameter	Type	Required	Description
`page`	integer	No	Page number (default: 1, min: 1)

Example Requests

GET https://api.earningsapi.com/v1/summaries?page=1&apikey=YOUR_API_KEY

Response Example

[
  {
    "id": "armlogi-holding-corp-announces-second-quarter-and-first-half-of-fiscal-year-2026-results",
    "title": "Armlogi Holding Corp. Reports Q2 and First Half Fiscal 2026 Earnings",
    "isoDate": "2026-02-14T04:02:00.000Z",
    "symbols": [{ "exchange": "NASDAQ", "symbol": "BTOC" }],
    "symbolStrings": ["BTOC"],
    "type": "earnings",
    "excerpt": "In the second quarter of fiscal 2026, Armlogi Holding Corp. reported total revenue of $51.5 million,..."
  },
  {
    "id": "natural-alternatives-international-inc-announces-2026-q2-and-ytd-results",
    "title": "Natural Alternatives International Reports Q2 2026 Financial Results",
    "isoDate": "2026-02-13T21:30:00.000Z",
    "symbols": [{ "exchange": "NASDAQ", "symbol": "NAII" }],
    "symbolStrings": ["NAII"],
    "type": "earnings",
    "excerpt": "In the second quarter of fiscal year 2026, Natural Alternatives International, Inc. reported net sal..."
  },
  {
    "id": "edesa-biotech-reports-fiscal-1st-quarter-2026-results",
    "title": "Edesa Biotech Reports Fiscal Q1 2026 Results",
    "isoDate": "2026-02-13T21:20:00.000Z",
    "symbols": [{ "exchange": "NASDAQ", "symbol": "EDSA" }],
    "symbolStrings": ["EDSA"],
    "type": "earnings",
    "excerpt": "In the first quarter of fiscal 2026, Edesa Biotech reported a net loss of $2.2 million, or $0.28 per..."
  }
]

📰 Summaries Deep Dive

Advanced examples and use cases for Summaries.

View Details →

Get Summary by ID

GET/v1/summaries/{id}

Retrieve the full earnings press release summary for a specific ID.

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	Unique identifier

Example Request

GET https://api.earningsapi.com/v1/summaries/zillow-group-reports-fourth-quarter-and-full-year-2025-financial-results-302684089?apikey=YOUR_API_KEY

Response Example

{
"id": "zillow-group-reports-fourth-quarter-and-full-year-2025-financial-results-302684089",
"title": "Zillow Group Reports Strong Q4 and Full-Year 2025 Results",
"content": "Zillow Group, Inc. reported its fourth-quarter results, achieving a revenue of $654 million, which represents an 18% increase year over year. The company posted a net income of $3 million for Q4, up from a net loss of $52 million in the same period last year. For the full year 2025, Zillow generated $2.6 billion in revenue, a 16% increase compared to 2024, and reported a total net income of $23 million. In Q4, revenue from the For Sale segment rose by 11% to $475 million, while Rentals revenue surged by 45% to $168 million, driven primarily by a 63% increase in multifamily revenue. Additionally, the Mortgages segment saw significant growth, with revenue jumping 39% to $57 million, attributed to a 67% rise in purchase loan origination volume. Adjusted EBITDA for Q4 was reported at $149 million, marking a 23% margin, which indicates improved cost management alongside revenue growth. The company ended the quarter with cash and investments totaling $1.3 billion, down from $1.4 billion at the end of the previous quarter. Zillow's unique monthly user traffic increased by 8% year over year, reaching 221 million, while total visits for Q4 rose to 2.1 billion, up 2% from the previous year. The company's overall performance exceeded the growth rates of the residential real estate industry, which grew by 3% in Q4 and for the full year.",
"isoDate": "2026-02-10T21:05:00.000Z",
"symbols": [{
"exchange": "NASDAQ",
"symbol": "Z"
}],
"symbolStrings": ["Z"],
"type": "earnings"
}

Response Fields

Field	Type	Description
`id`	string	Unique identifier for the summary (used in /v1/summaries/{id})
`symbol`	string	Primary stock symbol (e.g., "AAPL")
`type`	string	Content type (e.g., "press")
`title`	string	Title of the summary
`content`	string	Full summary content
`isoDate`	string	ISO timestamp (e.g., "2025-05-17T21:00:00Z")
`symbols`	array	Related symbols (objects with exchange and symbol)

📰 Summaries Deep Dive

Advanced examples and use cases for Summaries.

View Details →

SDKs & Code Examples

Integration examples in popular programming languages.

JavaScript / Node.js

Get Earnings Calendar

const response = await fetch('https://api.earningsapi.com/v1/calendar/earnings?date=2025-07-02&apikey=YOUR_API_KEY');
const calendar = await response.json();
console.log('Pre-market:', calendar.pre);
console.log('After-hours:', calendar.after);

Get Summaries

const response = await fetch('https://api.earningsapi.com/v1/summaries?page=1&apikey=YOUR_API_KEY');
const data = await response.json();
console.log(data);

🐍

Python

Get Earnings Calendar

import requests

response = requests.get('https://api.earningsapi.com/v1/calendar/earnings?date=2025-07-02&apikey=YOUR_API_KEY')
calendar = response.json()
print(calendar['pre'])
print(calendar['after'])

Get Summaries

import requests

response = requests.get('https://api.earningsapi.com/v1/summaries?page=1&apikey=YOUR_API_KEY')
data = response.json()
print(data)

cURL

Get Earnings Calendar

curl "https://api.earningsapi.com/v1/calendar/earnings?date=2025-07-02&apikey=YOUR_API_KEY"

Get Summaries

curl "https://api.earningsapi.com/v1/summaries?page=1&apikey=YOUR_API_KEY"

Quota & Limits

Understand how free tier quota resets and what happens when you hit your limit.

Free Tier Usage Quota

Free tier quota resets every 30 days based on your account creation date (Eastern Time). Your next reset date is shown in the dashboard.

• Quota resets automatically every 30 days
• Reset date is based on your account creation date (ET)
• Check Dashboard for current usage and next reset date