Returns the earnings data
curl --request GET \
--url 'https://api.benzinga.com/api/v2.1/calendar/earnings?token=' \
--header 'accept: <accept>'import requests
url = "https://api.benzinga.com/api/v2.1/calendar/earnings?token="
headers = {"accept": "<accept>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {accept: '<accept>'}};
fetch('https://api.benzinga.com/api/v2.1/calendar/earnings?token=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.benzinga.com/api/v2.1/calendar/earnings?token=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"accept: <accept>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.benzinga.com/api/v2.1/calendar/earnings?token="
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("accept", "<accept>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.benzinga.com/api/v2.1/calendar/earnings?token=")
.header("accept", "<accept>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.benzinga.com/api/v2.1/calendar/earnings?token=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["accept"] = '<accept>'
response = http.request(request)
puts response.read_body{
"earnings": [
{
"currency": "USD",
"cusip": "037833100",
"date": "2026-10-29",
"date_confirmed": 0,
"eps": "",
"eps_est": "1.990",
"eps_prior": "1.850",
"eps_surprise": "",
"eps_surprise_percent": "",
"eps_type": "",
"exchange": "NASDAQ",
"id": "69030cfb619d3a00015b72a3",
"importance": 5,
"isin": "US0378331005",
"name": "Apple",
"notes": "",
"period": "Q4",
"period_year": 2026,
"revenue": "",
"revenue_est": "",
"revenue_prior": "102466000000.000",
"revenue_surprise": "",
"revenue_surprise_percent": "",
"revenue_type": "",
"ticker": "AAPL",
"time": "16:00:00",
"updated": 1766187011
}
]
}
{
"ok": false,
"errors": [
{
"code": "auth_failed",
"id": "unauthorized",
"value": "Invalid or missing authentication token"
}
]
}
{
"ok": false,
"errors": [
{
"code": "no_data_found",
"id": "not_found",
"value": "No data found for the specified parameters"
}
]
}
{
"ok": false,
"errors": [
{
"code": "internal_server_error",
"id": "server_error",
"value": "An unexpected error occurred while processing your request"
}
]
}
Calendars
Earnings
Returns earnings data for a selected period and/or security. Includes actual EPS and revenue figures, estimates, surprises, and historical comparisons. Earnings data is crucial for investors to assess company performance.
GET
/
api
/
v2.1
/
calendar
/
earnings
Returns the earnings data
curl --request GET \
--url 'https://api.benzinga.com/api/v2.1/calendar/earnings?token=' \
--header 'accept: <accept>'import requests
url = "https://api.benzinga.com/api/v2.1/calendar/earnings?token="
headers = {"accept": "<accept>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {accept: '<accept>'}};
fetch('https://api.benzinga.com/api/v2.1/calendar/earnings?token=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.benzinga.com/api/v2.1/calendar/earnings?token=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"accept: <accept>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.benzinga.com/api/v2.1/calendar/earnings?token="
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("accept", "<accept>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.benzinga.com/api/v2.1/calendar/earnings?token=")
.header("accept", "<accept>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.benzinga.com/api/v2.1/calendar/earnings?token=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["accept"] = '<accept>'
response = http.request(request)
puts response.read_body{
"earnings": [
{
"currency": "USD",
"cusip": "037833100",
"date": "2026-10-29",
"date_confirmed": 0,
"eps": "",
"eps_est": "1.990",
"eps_prior": "1.850",
"eps_surprise": "",
"eps_surprise_percent": "",
"eps_type": "",
"exchange": "NASDAQ",
"id": "69030cfb619d3a00015b72a3",
"importance": 5,
"isin": "US0378331005",
"name": "Apple",
"notes": "",
"period": "Q4",
"period_year": 2026,
"revenue": "",
"revenue_est": "",
"revenue_prior": "102466000000.000",
"revenue_surprise": "",
"revenue_surprise_percent": "",
"revenue_type": "",
"ticker": "AAPL",
"time": "16:00:00",
"updated": 1766187011
}
]
}
{
"ok": false,
"errors": [
{
"code": "auth_failed",
"id": "unauthorized",
"value": "Invalid or missing authentication token"
}
]
}
{
"ok": false,
"errors": [
{
"code": "no_data_found",
"id": "not_found",
"value": "No data found for the specified parameters"
}
]
}
{
"ok": false,
"errors": [
{
"code": "internal_server_error",
"id": "server_error",
"value": "An unexpected error occurred while processing your request"
}
]
}
{
"earnings": [
{
"currency": "USD",
"cusip": "037833100",
"date": "2026-10-29",
"date_confirmed": 0,
"eps": "",
"eps_est": "1.990",
"eps_prior": "1.850",
"eps_surprise": "",
"eps_surprise_percent": "",
"eps_type": "",
"exchange": "NASDAQ",
"id": "69030cfb619d3a00015b72a3",
"importance": 5,
"isin": "US0378331005",
"name": "Apple",
"notes": "",
"period": "Q4",
"period_year": 2026,
"revenue": "",
"revenue_est": "",
"revenue_prior": "102466000000.000",
"revenue_surprise": "",
"revenue_surprise_percent": "",
"revenue_type": "",
"ticker": "AAPL",
"time": "16:00:00",
"updated": 1766187011
}
]
}
{
"ok": false,
"errors": [
{
"code": "auth_failed",
"id": "unauthorized",
"value": "Invalid or missing authentication token"
}
]
}
{
"ok": false,
"errors": [
{
"code": "no_data_found",
"id": "not_found",
"value": "No data found for the specified parameters"
}
]
}
{
"ok": false,
"errors": [
{
"code": "internal_server_error",
"id": "server_error",
"value": "An unexpected error occurred while processing your request"
}
]
}
Authorizations
Headers
Specifies return format. Query parameters work the same for both formats
Available options:
application/json Query Parameters
Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date
Number of results returned. Limit 1000
Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest
Date to query from point in time
Date to query to point in time
Field sort option for earnings calendar. Apply :desc, :asc for sort order
Available options:
date The importance level to filter by. Uses Greater Than or Equal To the importance indicated
Available options:
0, 1, 2, 3, 4, 5 One or more ticker symbols separated by a comma. Maximum 50 tickers
Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated
Response
success
API response containing an array of earnings records
Array of earnings records
Show child attributes
Show child attributes
Was this page helpful?