Skip to main content
GET
/
api
/
v2.1
/
calendar
/
economics
Returns the economic calendar data
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/economics?token=' \
  --header 'accept: <accept>'
{
  "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
    }
  ]
}

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

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_category
string<csv>

One or more categories separated by a comma

Response

success

โ€‹
economics
object[]