Skip to main content
Server path: /benzinga-calendar | Type: Application | PCID required: Yes

Tools

ToolDescription
benzinga_calendar_get_conference_callsReturns Conference call data
benzinga_calendar_get_consensus_ratingsReturns analyst ratings data]
benzinga_calendar_get_dividendsDividends Events
benzinga_calendar_get_dividends_1Dividends Events
benzinga_calendar_get_earningsReturns the earnings data
benzinga_calendar_get_economicsReturns the economic calendar data
benzinga_calendar_get_fdaFDA approvals, clinical trials, and PDUFA dates
benzinga_calendar_get_guidanceReturns guidance data
benzinga_calendar_get_iposReturns ipo data
benzinga_calendar_get_maReturns the mergers and acquisitions data
benzinga_calendar_get_offeringsReturns Secondary Offering data
benzinga_calendar_get_ratingsReturns analyst ratings data
benzinga_calendar_get_ratings_analystsReturns the full list of analysts that are providing ratings.
benzinga_calendar_get_ratings_firmsReturns the available firms providing analyst ratings
benzinga_calendar_get_removedReturns the removed calendar data
benzinga_calendar_get_splitsReturns the splits calendar data

benzinga_calendar_get_conference_calls

Returns Conference call data Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoPage offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.
pagesizeintegerNoNumber of results returned. Limit 1000
parameters[date]stringNoDate to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest.
parameters[date_from]stringNoDate to query from point in time.
parameters[date_to]stringNoDate to query to point in time.
parameters[tickers]stringNoOne or more ticker symbols separated by a comma. All calendars accept this parameter (not including the FDA endpoint; for the FDA endpoint, please use “parameters[securities]” instead). Ignored by the Economics endpoint. Maximum 50 tickers. Note that for the IPOs endpoint, new tickers may not return results right away as we do not automatically link them to the underlying company’s data. Thus, to obtain the most recent rows from the IPOs endpoint, send queries without this parameter specified.
parameters[updated]integerNoRecords last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.

benzinga_calendar_get_consensus_ratings

Returns analyst ratings data] Parameters:
ParameterTypeRequiredDefaultDescription
pagesizeintegerNoNumber of results returned. Limit 1000
parameters[date_from]stringNoDate to query from point in time.
parameters[date_to]stringNoDate to query to point in time.
parameters[tickers]stringNoOne ticker symbol to query the aggregate for. All calendars accept this parameter (not including the FDA endpoint; for the FDA endpoint, please use “parameters[securities]” instead). Ignored by the Economics endpoint. Maximum 1 ticker.
simplifybooleanNoTo simplify the aggregate ratings to only BUY, SELL, HOLD, default will return all ratings (STRONG_BUY, BUY, HOLD, SELL, STRONG_SELL).
aggregate_typestringNoTo aggregate the ratings by either number or percentage.

benzinga_calendar_get_dividends

Dividends Events Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoPage offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.
pagesizeintegerNoNumber of results returned. Limit 1000
parameters[date]stringNoDate to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest.
parameters[date_from]stringNoDate to query from point in time.
parameters[date_to]stringNoDate to query to point in time.
parameters[tickers]stringNoOne or more ticker symbols separated by a comma. All calendars accept this parameter (not including the FDA endpoint; for the FDA endpoint, please use “parameters[securities]” instead). Ignored by the Economics endpoint. Maximum 50 tickers. Note that for the IPOs endpoint, new tickers may not return results right away as we do not automatically link them to the underlying company’s data. Thus, to obtain the most recent rows from the IPOs endpoint, send queries without this parameter specified.
parameters[importance]integerNoThe importance level to filter by. Uses Greater Than or Equal To the importance indicated
parameters[date_sort]stringNoDividend date field to sort on (newest to oldest)
parameters[updated]integerNoRecords last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.
parameters[dividend_yield_operation]stringNoSpecifies how to filter using dividend yield. gt = Greater Than, gte = Greater Than Equal, eq = Equal, lt = Less Than, lte = Less Than Equal
parameters[dividend_yield]numberNoThe dividend yield amount to filter by. Defaults to using Equal To the amount indicated. 1 =100%eater Than or Equal To’, ‘Equal To’, ‘Less Than or Equal To’, and ‘Less Than’ filters respectively.

benzinga_calendar_get_dividends_1

Dividends Events Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoPage offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.
pagesizeintegerNoNumber of results returned. Limit 1000
parameters[date]stringNoDate to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest.
parameters[date_from]stringNoDate to query from point in time.
parameters[date_to]stringNoDate to query to point in time.
parameters[tickers]stringNoOne or more ticker symbols separated by a comma. All calendars accept this parameter (not including the FDA endpoint; for the FDA endpoint, please use “parameters[securities]” instead). Ignored by the Economics endpoint. Maximum 50 tickers. Note that for the IPOs endpoint, new tickers may not return results right away as we do not automatically link them to the underlying company’s data. Thus, to obtain the most recent rows from the IPOs endpoint, send queries without this parameter specified.
parameters[importance]integerNoThe importance level to filter by. Uses Greater Than or Equal To the importance indicated
parameters[date_sort]stringNoDividend date field to sort on (newest to oldest)
parameters[updated]integerNoRecords last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.
parameters[dividend_yield_operation]stringNoSpecifies how to filter using dividend yield. gt = Greater Than, gte = Greater Than Equal, eq = Equal, lt = Less Than, lte = Less Than Equal
parameters[dividend_yield]numberNoThe dividend yield amount to filter by. Defaults to using Equal To the amount indicated. 1 =100%eater Than or Equal To’, ‘Equal To’, ‘Less Than or Equal To’, and ‘Less Than’ filters respectively.

benzinga_calendar_get_earnings

Returns the earnings data Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoPage offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.
pagesizeintegerNoNumber of results returned. Limit 1000
parameters[date]stringNoDate to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest.
parameters[date_from]stringNoDate to query from point in time.
parameters[date_to]stringNoDate to query to point in time.
parameters[date_sort]stringNoField sort option for earnings calendar. Apply :desc, :asc for sort order.
parameters[tickers]stringNoOne or more ticker symbols separated by a comma. All calendars accept this parameter (not including the FDA endpoint; for the FDA endpoint, please use “parameters[securities]” instead). Ignored by the Economics endpoint. Maximum 50 tickers. Note that for the IPOs endpoint, new tickers may not return results right away as we do not automatically link them to the underlying company’s data. Thus, to obtain the most recent rows from the IPOs endpoint, send queries without this parameter specified.
parameters[importance]integerNoThe importance level to filter by. Uses Greater Than or Equal To the importance indicated
parameters[updated]integerNoRecords last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.

benzinga_calendar_get_economics

Returns the economic calendar data Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoPage offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.
pagesizeintegerNoNumber of results returned. Limit 1000
parameters[date]stringNoDate to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest.
parameters[date_from]stringNoDate to query from point in time.
parameters[date_to]stringNoDate to query to point in time.
parameters[importance]integerNoThe importance level to filter by. Uses Greater Than or Equal To the importance indicated
parameters[updated]integerNoRecords last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.
countrystringNo3-Digit Country Code
event_categorystringNoOne or more categories separated by a comma.

benzinga_calendar_get_fda

FDA approvals, clinical trials, and PDUFA dates Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoPage offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.
pagesizeintegerNoNumber of results returned. Limit 1000
parameters[date]stringNoDate to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest.
parameters[date_from]stringNoDate to query from point in time.
parameters[date_to]stringNoDate to query to point in time.
parameters[date_search_field]stringNoDate to filter and sort calendar by. Default is announced.
parameters[date_search_strict]booleanNoSome date fields (such as the FDA calendar target date) include fuzzy dates such as 2021-Q1. When filtering, you may choose to allow fuzzy date matching, or strict date matching that searches for ONLY dates that have an exact match within the given date period. Default TRUE.
parameters[securities]stringNoOne or more security identifiers separated by a comma. Maximum 50 securities. Security identifiers must be in the format of ticker symbols, only for US-listed equities.
parameters[updated]integerNoRecords last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.

benzinga_calendar_get_guidance

Returns guidance data Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoPage offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.
pagesizeintegerNoNumber of results returned. Limit 1000
parameters[date]stringNoDate to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest.
parameters[date_from]stringNoDate to query from point in time.
parameters[date_to]stringNoDate to query to point in time.
parameters[tickers]stringNoOne or more ticker symbols separated by a comma. All calendars accept this parameter (not including the FDA endpoint; for the FDA endpoint, please use “parameters[securities]” instead). Ignored by the Economics endpoint. Maximum 50 tickers. Note that for the IPOs endpoint, new tickers may not return results right away as we do not automatically link them to the underlying company’s data. Thus, to obtain the most recent rows from the IPOs endpoint, send queries without this parameter specified.
parameters[importance]integerNoThe importance level to filter by. Uses Greater Than or Equal To the importance indicated
parameters[updated]integerNoRecords last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.
parameters[is_primary]stringNoDetermines if guidance returned is primary, secondary or all. Default set to Y.

benzinga_calendar_get_ipos

Returns ipo data Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoPage offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.
pagesizeintegerNoNumber of results returned. Limit 1000
parameters[date]stringNoDate to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest.
parameters[date_from]stringNoDate to query from point in time.
parameters[date_to]stringNoDate to query to point in time.
parameters[ipo_type]stringNoOne or more IPO types separated by a comma. Example: Ordinary Shares,SPAC
parameters[tickers]stringNoOne or more ticker symbols separated by a comma. All calendars accept this parameter (not including the FDA endpoint; for the FDA endpoint, please use “parameters[securities]” instead). Ignored by the Economics endpoint. Maximum 50 tickers. Note that for the IPOs endpoint, new tickers may not return results right away as we do not automatically link them to the underlying company’s data. Thus, to obtain the most recent rows from the IPOs endpoint, send queries without this parameter specified.
parameters[updated]integerNoRecords last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.

benzinga_calendar_get_ma

Returns the mergers and acquisitions data Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoPage offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.
pagesizeintegerNoNumber of results returned. Limit 1000
parameters[date]stringNoDate to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest.
parameters[date_from]stringNoDate to query from point in time.
parameters[date_to]stringNoDate to query to point in time.
parameters[tickers]stringNoOne or more ticker symbols separated by a comma. All calendars accept this parameter (not including the FDA endpoint; for the FDA endpoint, please use “parameters[securities]” instead). Ignored by the Economics endpoint. Maximum 50 tickers. Note that for the IPOs endpoint, new tickers may not return results right away as we do not automatically link them to the underlying company’s data. Thus, to obtain the most recent rows from the IPOs endpoint, send queries without this parameter specified.
parameters[importance]integerNoThe importance level to filter by. Uses Greater Than or Equal To the importance indicated
parameters[updated]integerNoRecords last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.
parameters[date_sort]stringNoM&A date field to sort on (newest to oldest for expected and completed; oldest to newest for announced)

benzinga_calendar_get_offerings

Returns Secondary Offering data Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoPage offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.
pagesizeintegerNoNumber of results returned. Limit 1000
parameters[date]stringNoDate to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest.
parameters[date_from]stringNoDate to query from point in time.
parameters[date_to]stringNoDate to query to point in time.
parameters[tickers]stringNoOne or more ticker symbols separated by a comma. All calendars accept this parameter (not including the FDA endpoint; for the FDA endpoint, please use “parameters[securities]” instead). Ignored by the Economics endpoint. Maximum 50 tickers. Note that for the IPOs endpoint, new tickers may not return results right away as we do not automatically link them to the underlying company’s data. Thus, to obtain the most recent rows from the IPOs endpoint, send queries without this parameter specified.
parameters[importance]integerNoThe importance level to filter by. Uses Greater Than or Equal To the importance indicated
parameters[updated]integerNoRecords last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.

benzinga_calendar_get_ratings

Returns analyst ratings data Parameters:
ParameterTypeRequiredDefaultDescription
fieldsstringNoAvailable fields: - id - date - time - ticker - exchange - name - currency - action_pt - action_company - rating_current - pt_current - rating_prior - pt_prior - pt_pct_change - url - url_calendar - url_news - analyst - analyst_id - analyst_name - ratings_accuracy - importance - notes - updated Default fields: - id - date - time - ticker - exchange - name - currency - action_pt - action_company - rating_current - pt_current - rating_prior - pt_prior - url - url_calendar - url_news - analyst - analyst_name - importance - notes - updated
pageintegerNoPage offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.
pagesizeintegerNoNumber of results returned. Limit 1000
parameters[date]stringNoDate to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest.
parameters[date_from]stringNoDate to query from point in time.
parameters[date_to]stringNoDate to query to point in time.
parameters[tickers]stringNoOne or more ticker symbols separated by a comma. All calendars accept this parameter (not including the FDA endpoint; for the FDA endpoint, please use “parameters[securities]” instead). Ignored by the Economics endpoint. Maximum 50 tickers. Note that for the IPOs endpoint, new tickers may not return results right away as we do not automatically link them to the underlying company’s data. Thus, to obtain the most recent rows from the IPOs endpoint, send queries without this parameter specified.
parameters[importance]integerNoThe importance level to filter by. Uses Greater Than or Equal To the importance indicated
parameters[updated]integerNoRecords last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.
parameters[action]stringNoFilter by a specific action_company (action for rating). Note that all of these terms are precisely defined.
parameters[analyst_id]stringNoOne or more analyst ids (analyst_id) separated by a comma.
parameters[firm_id]stringNoOne or more firm ids (firm_id) separated by a comma.
analyststringNoA comma separated list of analyst (person) ID’s to bring back. Omitting will bring back all available analysts.
firmstringNoA comma separated list of analyst firm ID’s to bring back. Omitting will bring back all available firms.

benzinga_calendar_get_ratings_analysts

Returns the full list of analysts that are providing ratings. Parameters:
ParameterTypeRequiredDefaultDescription
fieldsstringNoDefault fields: - id - name_first - name_last - name_full - firm_id - firm_name - ratings_accuracy - updated
analyststringNoA comma separated list of analyst (person) ID’s to bring back. Omitting will bring back all available analysts.
firmstringNoA comma separated list of analyst firm ID’s to bring back. Omitting will bring back all available firms.
firm_namestringNoA comma separated list of analyst firm names to bring back. Omitting will bring back all available firms.
analyst_namestringNoA comma separated list of analyst names to bring back. Omitting will bring back all available analysts.
pageintegerNoPage offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.
pageSizeintegerNoNumber of results returned. Limit 1000. Default 50.
updatedintegerNoRecords removed after Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.

benzinga_calendar_get_ratings_firms

Returns the available firms providing analyst ratings Parameters:
ParameterTypeRequiredDefaultDescription
fieldsstringNoAvailable fields: - id - name - currency - homepage - updated Default fields: - id - name
firmstringNoA comma separated list of analyst firm ID’s to bring back. Omitting will bring back all available firms.
pageintegerNoPage offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.
pageSizeintegerNoNumber of results returned. Limit 1000. Default 50.
updatedintegerNoRecords removed after Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.

benzinga_calendar_get_removed

Returns the removed calendar data Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoPage offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.
pageSizeintegerNoNumber of results returned. Limit 1000. Default 50.
typestringNoCalendar type
updatedintegerNoRecords removed after Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.

benzinga_calendar_get_splits

Returns the splits calendar data Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoPage offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.
pagesizeintegerNoNumber of results returned. Limit 1000
parameters[date]stringNoDate to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest.
parameters[date_from]stringNoDate to query from point in time.
parameters[date_to]stringNoDate to query to point in time.
parameters[date_search_field]stringNoDate to filter and sort calendar by. Default is announced.
parameters[tickers]stringNoOne or more ticker symbols separated by a comma. All calendars accept this parameter (not including the FDA endpoint; for the FDA endpoint, please use “parameters[securities]” instead). Ignored by the Economics endpoint. Maximum 50 tickers. Note that for the IPOs endpoint, new tickers may not return results right away as we do not automatically link them to the underlying company’s data. Thus, to obtain the most recent rows from the IPOs endpoint, send queries without this parameter specified.
parameters[importance]integerNoThe importance level to filter by. Uses Greater Than or Equal To the importance indicated
parameters[updated]integerNoRecords last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.