Economics

Returns economic calendar data including economic indicators, releases, and reports from various countries. Includes actual values, consensus estimates, and prior values for economic events such as GDP, employment data, inflation metrics, and more.

GET /api/v2.1/calendar/economics

Returns the economic calendar data

cURL

curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/economics?token=' \
  --header 'accept: <accept>'

import requests

url = "https://api.benzinga.com/api/v2.1/calendar/economics?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/economics?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/economics?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/economics?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/economics?token=")
  .header("accept", "<accept>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.benzinga.com/api/v2.1/calendar/economics?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

Response (200 OK)

{
  "economics": [
    {
      "actual": "",
      "actual_t": "%",
      "consensus": "",
      "consensus_t": "",
      "country": "USA",
      "date": "2026-03-08",
      "description": "Challenger Job Cuts (YoY) report tracks the percentage change in layoffs reported by employers during a given month compared to the same month of the previous year. This report is used by investors and analysts to gauge the strength of the labor market and make informed decisions about their investments. The data in this report can also impact the value of the US dollar, with higher than expected numbers being seen as negative and lower than expected numbers being seen as positive.",
      "event_category": "Employment",
      "event_name": "Challenger Job Cuts (YoY)",
      "event_period": "",
      "id": "6745790147f2830001365a27",
      "importance": 1,
      "notes": "",
      "period_year": 2026,
      "prior": "",
      "prior_t": "%",
      "time": "02:30:09",
      "updated": 1736341667
    }
  ]
}

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

Response (200 OK)

{
  "economics": [
    {
      "actual": "",
      "actual_t": "%",
      "consensus": "",
      "consensus_t": "",
      "country": "USA",
      "date": "2026-03-08",
      "description": "Challenger Job Cuts (YoY) report tracks the percentage change in layoffs reported by employers during a given month compared to the same month of the previous year. This report is used by investors and analysts to gauge the strength of the labor market and make informed decisions about their investments. The data in this report can also impact the value of the US dollar, with higher than expected numbers being seen as negative and lower than expected numbers being seen as positive.",
      "event_category": "Employment",
      "event_name": "Challenger Job Cuts (YoY)",
      "event_period": "",
      "id": "6745790147f2830001365a27",
      "importance": 1,
      "notes": "",
      "period_year": 2026,
      "prior": "",
      "prior_t": "%",
      "time": "02:30:09",
      "updated": 1736341667
    }
  ]
}

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

token · string · query · required

Headers

accept · enum<string> · default: application/json · required

Specifies return format. Query parameters work the same for both formats

Available options: application/json

Query Parameters

page · integer · default: 0

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

pagesize · integer

Number of results returned. Limit 1000

Required range: x <= 1000

parameters[date] · string<YYYY-MM-DD>

Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest

parameters[date_from] · string<YYYY-MM-DD>

Date to query from point in time

parameters[date_to] · string<YYYY-MM-DD>

Date to query to point in time

parameters[importance] · enum<integer>

The importance level to filter by. Uses Greater Than or Equal To the importance indicated

Available options: 1, 2, 3

parameters[updated] · integer

Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated

country · string<A-Z:3>

3-Digit Country Code (e.g., USA, CAN, GBR)

event_name · string<csv>

One or more event name prefixes separated by a comma (e.g., CPI matches CPI, CPI (MoM), CPI (Mom) - Prelim)

event_category · string<csv>

One or more categories separated by a comma

Response

200

application/json

success

API response containing an array of economic event records

economics · object[]

Show child attributes