Calendar API Reference

This REST API returns structured data for dividends, earnings, future earnings dates, conference calls, economics, guidance, IPOs, ratings, retail sales, splits.

API Endpoint
https://api.benzinga.com/api/v2
Response Content-Types

application/json, application/xml

Schemes

https, http

Version

2.0.0

Authentication

token authentication

Type:
apiKey
Name:
token
In:
query

Playground

Endpoints

GET /calendar/dividends

Dividends Events

Returns dividends data for a selected period and/or security.

Parameters

NameTypeLocationDescription
acceptstring , x ∈ { application/json , application/xml (default) }header

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

pageintegerquery

Page offset.

pagesizeintegerquery

Number of results returned. Limit 1000

parameters[date]string (YYYY-MM-DD)query

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)query

Date to query from point in time.

parameters[date_to]string (YYYY-MM-DD)query

Date to query to point in time.

parameters[tickers]string (csv)query

One or more ticker symbols separated by a comma. All calendar accept this parameter. Ignored by Economics.

parameters[importance]integer , x ∈ { 1 , 2 , 3 , 4 , 5 }query

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

parameters[date_sort]string (announced | ex | payable | record)query

Dividend date field to sort on

parameters[updated]integer (int64)query

Records 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]string , x ∈ { gt , gte , eq , lte , lt }query

Specifies 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]number (double)query

The 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.

Responses

CodeModelDescription
200 OKdividends

Success

Response (200 OK)

[
  {
    "id": "integer",
    "updated": "integer",
    "active": "integer",
    "date": "string (YYYY-DD-MM)",
    "time": "string (HH:MM:SS)",
    "ticker": "string",
    "exchange": "string",
    "frequency": "integer",
    "dividend": "number (double)",
    "dividend_prior": "number (double)",
    "dividend_type": "string",
    "dividend_yield": "string",
    "ex_dividend_date": "string",
    "payable_date": "string",
    "record_date": "string",
    "importance": "string (0-5)"
  }
]

GET /calendar/earnings

Returns the earnings data

Parameters

NameTypeLocationDescription
acceptstring , x ∈ { application/json , application/xml (default) }header

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

pageintegerquery

Page offset.

pagesizeintegerquery

Number of results returned. Limit 1000

parameters[date]string (YYYY-MM-DD)query

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)query

Date to query from point in time.

parameters[date_to]string (YYYY-MM-DD)query

Date to query to point in time.

parameters[tickers]string (csv)query

One or more ticker symbols separated by a comma. All calendar accept this parameter. Ignored by Economics.

parameters[importance]integer , x ∈ { 1 , 2 , 3 , 4 , 5 }query

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

parameters[date_sort]string (announced | ex | payable | record)query

Dividend date field to sort on

parameters[updated]integer (int64)query

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

Responses

CodeModelDescription
200 OK

success

Response (200 OK)

{
  "earnings": [
    {
      "id": "string",
      "updated": "integer",
      "active": "integer",
      "date": "string",
      "time": "string (HH:MM:SS)",
      "ticker": "string",
      "importance": "integer",
      "period": "string (Q[1-4])",
      "period_year": "integer (XXXX)",
      "date_confirmed": "string (Y/N)",
      "eps": "number (double)",
      "eps_estt": "number (double)",
      "eps_prior": "number (double)",
      "revenue": "number (double)",
      "revenue_es": "number (double)"
    }
  ]
}

GET /calendar/splits

Returns the splits calendar data

Parameters

NameTypeLocationDescription
acceptstring , x ∈ { application/json , application/xml (default) }header

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

pageintegerquery

Page offset.

pagesizeintegerquery

Number of results returned. Limit 1000

parameters[date]string (YYYY-MM-DD)query

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)query

Date to query from point in time.

parameters[date_to]string (YYYY-MM-DD)query

Date to query to point in time.

parameters[tickers]string (csv)query

One or more ticker symbols separated by a comma. All calendar accept this parameter. Ignored by Economics.

parameters[importance]integer , x ∈ { 1 , 2 , 3 , 4 , 5 }query

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

parameters[updated]integer (int64)query

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

Responses

CodeModelDescription
200 OKsplits

success

Response (200 OK)

[
  {
    "id": "integer",
    "updated": "integer",
    "active": "integer",
    "date": "string (YYYY-DD-MM)",
    "time": "string (HH:MM:SS)",
    "ticker": "string",
    "exchange": "string",
    "importance": "string (0-5)",
    "ratio": "string (x/x)",
    "optionable": "string",
    "date_ex": "string (YYYY-MM-DD)",
    "date_recorded": "string (YYYY-MM-DD)",
    "date_distribution": "string (YYYY-MM-DD)"
  }
]

GET /calendar/economics

Returns the economic calendar data

Parameters

NameTypeLocationDescription
acceptstring , x ∈ { application/json , application/xml (default) }header

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

pageintegerquery

Page offset.

pagesizeintegerquery

Number of results returned. Limit 1000

parameters[date]string (YYYY-MM-DD)query

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)query

Date to query from point in time.

parameters[date_to]string (YYYY-MM-DD)query

Date to query to point in time.

parameters[tickers]string (csv)query

One or more ticker symbols separated by a comma. All calendar accept this parameter. Ignored by Economics.

parameters[importance]integer , x ∈ { 1 , 2 , 3 , 4 , 5 }query

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

parameters[updated]integer (int64)query

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

countrystring (A-Z:3)query

3-Digit Country Code

Responses

CodeModelDescription
200 OKeconomics

success

Response (200 OK)

[
  {
    "id": "string",
    "date": "string (YYYY-MM-DD)",
    "time": "string (HH:MM)",
    "country": "string",
    "event_name": "string",
    "event_period": "string",
    "period_year": "string",
    "actual": "string",
    "actual_t": "string",
    "consensus": "string",
    "consensus_t": "string",
    "prior": "string",
    "updated": "integer",
    "description": "string"
  }
]

GET /calendar/guidance

Returns guidance data

Parameters

NameTypeLocationDescription
acceptstring , x ∈ { application/json , application/xml (default) }header

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

pageintegerquery

Page offset.

pagesizeintegerquery

Number of results returned. Limit 1000

parameters[date]string (YYYY-MM-DD)query

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)query

Date to query from point in time.

parameters[date_to]string (YYYY-MM-DD)query

Date to query to point in time.

parameters[tickers]string (csv)query

One or more ticker symbols separated by a comma. All calendar accept this parameter. Ignored by Economics.

parameters[importance]integer , x ∈ { 1 , 2 , 3 , 4 , 5 }query

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

parameters[updated]integer (int64)query

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

countrystring (A-Z:3)query

3-Digit Country Code

Responses

CodeModelDescription
200 OKguidance

success

Response (200 OK)

[
  {
    "id": "string",
    "date": "string (YYYY-MM-DD)",
    "time": "string (HH:MM:SS)",
    "ticker": "string",
    "exchange": "string",
    "name": "string",
    "period": "string (Q(N))",
    "period_year": "string (YYYY)",
    "prelim": "string (B)",
    "eps_guidance_est": "string (float)",
    "eps_guidance_max": "string (float)",
    "eps_guidance_min": "string (float)",
    "eps_guidance_prior_max": "string (float)",
    "eps_guidance_prior_min": "string (float)",
    "importance": "string (N)",
    "updated": "integer (int64)"
  }
]

GET /calendar/ipos

Returns initial public offering data

Parameters

NameTypeLocationDescription
acceptstring , x ∈ { application/json , application/xml (default) }header

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

pageintegerquery

Page offset.

pagesizeintegerquery

Number of results returned. Limit 1000

parameters[date]string (YYYY-MM-DD)query

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)query

Date to query from point in time.

parameters[date_to]string (YYYY-MM-DD)query

Date to query to point in time.

parameters[tickers]string (csv)query

One or more ticker symbols separated by a comma. All calendar accept this parameter. Ignored by Economics.

parameters[importance]integer , x ∈ { 1 , 2 , 3 , 4 , 5 }query

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

parameters[updated]integer (int64)query

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

Responses

CodeModelDescription
200 OKipos

success

Response (200 OK)

[
  {
    "id": "string",
    "date": "string (YYYY-MM-DD)",
    "time": "string (HH:MM:SS)",
    "ticker": "string",
    "exchange": "string",
    "name": "string",
    "pricing_date": "string",
    "price_min": "string",
    "price_max": "string",
    "deal_status": "string",
    "insider_lockup_days": "string",
    "insider_lockup_date": "string",
    "offering_value": "string (float)",
    "offering_shares": "string (float)",
    "shares_from_seling_holders": "string (int)",
    "other_underwriters": [
      "string"
    ],
    "underwriter_quiet_expiration_days": "string",
    "underwriter_quiet_expiration_date": "string",
    "updated": "integer (int64)",
    "lead_underwriters": [
      "string"
    ]
  }
]

GET /calendar/ratings

Returns analyst ratings data

Parameters

NameTypeLocationDescription
acceptstring , x ∈ { application/json , application/xml (default) }header

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

pageintegerquery

Page offset.

pagesizeintegerquery

Number of results returned. Limit 1000

parameters[date]string (YYYY-MM-DD)query

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)query

Date to query from point in time.

parameters[date_to]string (YYYY-MM-DD)query

Date to query to point in time.

parameters[tickers]string (csv)query

One or more ticker symbols separated by a comma. All calendar accept this parameter. Ignored by Economics.

parameters[importance]integer , x ∈ { 1 , 2 , 3 , 4 , 5 }query

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

parameters[updated]integer (int64)query

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

parameters[action]string , x ∈ { Upgrades , Downgrades , Maintains , Lowers , Raises , Initiates Coverage On , Terminates Coverage On }query

Filter by a specific action

Responses

CodeModelDescription
200 OKratings

success

Response (200 OK)

[
  {
    "id": "string",
    "date": "string (YYYY-MM-DD)",
    "url_calendar": "string (URI)",
    "url_news": "string (URI)",
    "time": "string (HH:MM:SS)",
    "ticker": "string",
    "exchange": "string",
    "name": "string",
    "action_pt": "string",
    "action_company": "string",
    "rating_current": "string",
    "rating_prior": "string",
    "url": "string (URI)",
    "importance": "string",
    "updated": "integer (int64)",
    "analyst": "string"
  }
]

GET /calendar/retail

Returns retail sales data

Parameters

NameTypeLocationDescription
acceptstring , x ∈ { application/json , application/xml (default) }header

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

pageintegerquery

Page offset.

pagesizeintegerquery

Number of results returned. Limit 1000

parameters[date]string (YYYY-MM-DD)query

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)query

Date to query from point in time.

parameters[date_to]string (YYYY-MM-DD)query

Date to query to point in time.

parameters[tickers]string (csv)query

One or more ticker symbols separated by a comma. All calendar accept this parameter. Ignored by Economics.

parameters[importance]integer , x ∈ { 1 , 2 , 3 , 4 , 5 }query

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

parameters[updated]integer (int64)query

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

Responses

CodeModelDescription
200 OKretail

success

Response (200 OK)

[
  {
    "id": "string",
    "date": "string (YYYY-MM-DD)",
    "time": "string (HH:MM:SS)",
    "ticker": "string",
    "exchange": "string",
    "name": "string",
    "importance": "string",
    "period": "string (QN)",
    "period_year": "string (YYYY)",
    "sss": "string (float)",
    "updated": "integer (int64)"
  }
]

GET /calendar/conference-calls

Returns retail sales data

Parameters

NameTypeLocationDescription
acceptstring , x ∈ { application/json , application/xml (default) }header

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

pageintegerquery

Page offset.

pagesizeintegerquery

Number of results returned. Limit 1000

parameters[date]string (YYYY-MM-DD)query

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)query

Date to query from point in time.

parameters[date_to]string (YYYY-MM-DD)query

Date to query to point in time.

parameters[tickers]string (csv)query

One or more ticker symbols separated by a comma. All calendar accept this parameter. Ignored by Economics.

parameters[updated]integer (int64)query

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

Responses

CodeModelDescription
200 OKconferenceCalls

success

Response (200 OK)

[
  {
    "id": "string",
    "date": "string (YYYY-MM-DD)",
    "time": "string (HH:MM:SS)",
    "name": "string",
    "exchange": "string",
    "ticker": "string",
    "start_time": "string (HH:MM:SS)",
    "phone_num": "string (NNN-NNN-NNNN)",
    "international_num": "string (NNN-NNN-NNNN)",
    "reservation_num": "string (NNN-NNN-NNNN)",
    "access_code": "string",
    "webcase_url": "string (URI)",
    "importance": "string",
    "updated": "integer (int64)"
  }
]

Models

dividends: object

PropertyTypeDescription
idinteger

Unique ID of this entry

updatedinteger

Last updated timestamp, UTC

activeinteger

1 = active item / 0 = delete or hide item (with field missing, assume 1)

datestring (YYYY-DD-MM)

Announced Date on calendar

timestring (HH:MM:SS)

Announced Time on Calendar, 24hr format

tickerstring

Ticker Symbol (F, MSFT, etc...)

exchangestring

Exchange (NYSE, NASDAQ, etc...)

frequencyinteger

Frequency of the dividend

dividendnumber (double)

Dividend value

dividend_priornumber (double)

Period prior dividend value

dividend_typestring

Type of dividend

dividend_yieldstring

Yield of dividend

ex_dividend_datestring

Dividend Ex Date

payable_datestring

Dividend Payable Date

record_datestring

Dividend Recorded Date

importancestring (0-5)

Subjective Basis of How Important Event is to Market. 5 = High.

Structure (JSON)
{
  "id": "integer",
  "updated": "integer",
  "active": "integer",
  "date": "string (YYYY-DD-MM)",
  "time": "string (HH:MM:SS)",
  "ticker": "string",
  "exchange": "string",
  "frequency": "integer",
  "dividend": "number (double)",
  "dividend_prior": "number (double)",
  "dividend_type": "string",
  "dividend_yield": "string",
  "ex_dividend_date": "string",
  "payable_date": "string",
  "record_date": "string",
  "importance": "string (0-5)"
}

earnings: object[]

object
PropertyTypeDescription
idstring-
updatedinteger

Last updated timestamp, UTC

activeinteger

1 = active item / 0 = delete or hide item (with field missing, assume 1)

datestring

Announced Date on Calendar

timestring (HH:MM:SS)

Announced Time on Calendar, 24hr format

tickerstring

Ticker Symbold (F, MSFT, etc...)

importanceinteger

Subjective Basis of How Important Event is to Market. 5=High

periodstring (Q[1-4])

Period of the earnings actual

period_yearinteger (XXXX)

Period Year of the earnings actual

date_confirmedstring (Y/N)

If the report date was confirmed (vs est)

epsnumber (double)

Comparable and Adjusted EPS

eps_esttnumber (double)

Adjusted EPS Consensus Aggregate Analyst Estimate

eps_priornumber (double)

Adjusted EPS from Prior Period

revenuenumber (double)

Revenue

revenue_esnumber (double)

Revenue Consensus Analyst Estimate

Structure (JSON)
[
  {
    "id": "string",
    "updated": "integer",
    "active": "integer",
    "date": "string",
    "time": "string (HH:MM:SS)",
    "ticker": "string",
    "importance": "integer",
    "period": "string (Q[1-4])",
    "period_year": "integer (XXXX)",
    "date_confirmed": "string (Y/N)",
    "eps": "number (double)",
    "eps_estt": "number (double)",
    "eps_prior": "number (double)",
    "revenue": "number (double)",
    "revenue_es": "number (double)"
  }
]

splits: object

PropertyTypeDescription
idinteger

Unique ID of this entry

updatedinteger

Last updated timestamp, UTC

activeinteger

1 = active item / 0 = delete or hide item (with field missing, assume 1)

datestring (YYYY-DD-MM)

Announced Date on calendar

timestring (HH:MM:SS)

Announced Time on Calendar, 24hr format

tickerstring

Ticker Symbol (F, MSFT, etc...)

exchangestring

Exchange (NYSE, NASDAQ, etc...)

importancestring (0-5)

Subjective Basis of How Important Event is to Market. 5=high

ratiostring (x/x)

Ratio of the split

optionablestring

is the script optionable?

date_exstring (YYYY-MM-DD)

Ex date

date_recordedstring (YYYY-MM-DD)

Recorded date

date_distributionstring (YYYY-MM-DD)

Distribution date

Structure (JSON)
{
  "id": "integer",
  "updated": "integer",
  "active": "integer",
  "date": "string (YYYY-DD-MM)",
  "time": "string (HH:MM:SS)",
  "ticker": "string",
  "exchange": "string",
  "importance": "string (0-5)",
  "ratio": "string (x/x)",
  "optionable": "string",
  "date_ex": "string (YYYY-MM-DD)",
  "date_recorded": "string (YYYY-MM-DD)",
  "date_distribution": "string (YYYY-MM-DD)"
}

economics: object

PropertyTypeDescription
idstring

Unique identifier for each data point

datestring (YYYY-MM-DD)-
timestring (HH:MM)

Announced Time on Calendar, 24hr format

countrystring

3-Character Country Code (USA, CA, etc...)

event_namestring

Economic Event

event_periodstring

Period of Time (Q1, September, Third Week of August,...)

period_yearstring

Period Year

actualstring-
actual_tstring-
consensusstring-
consensus_tstring-
priorstring-
updatedinteger

Last updated timestamp, UTC

descriptionstring

Event Description

Structure (JSON)
{
  "id": "string",
  "date": "string (YYYY-MM-DD)",
  "time": "string (HH:MM)",
  "country": "string",
  "event_name": "string",
  "event_period": "string",
  "period_year": "string",
  "actual": "string",
  "actual_t": "string",
  "consensus": "string",
  "consensus_t": "string",
  "prior": "string",
  "updated": "integer",
  "description": "string"
}

guidance: object

PropertyTypeDescription
idstring

Unique ID of this entry

datestring (YYYY-MM-DD)

Announced Date on Calendar

timestring (HH:MM:SS)

Announced Time on Calendar, 24hr format

tickerstring

Ticker symbol of company guidance data is for

exchangestring

Exchange (NYSE, NASDAQ, etc...)

namestring

The name of the publicly traded company that the guidance data is for

periodstring (Q(N)) , x ∈ { Q1 , Q2 , Q3 , Q4 }-
period_yearstring (YYYY)

Period Year of the earnings actual

prelimstring (B) , x ∈ { Y , N }

Yes or No for if guidance is a preliminary earnings report

eps_guidance_eststring (float)

Adjusted EPS Consensus Estimate

eps_guidance_maxstring (float)

Adjusted EPS from Prior Period Max

eps_guidance_minstring (float)

Adjusted EPS from Prior Period Min

eps_guidance_prior_maxstring (float)

Adjusted EPS from Prior Period Max

eps_guidance_prior_minstring (float)

Adjusted EPS from Prior Period Min

importancestring (N) , x ∈ { 1 , 2 , 3 , 4 , 5 }

Subjective Basis of How Important Event is to Market. 5 = High.

updatedinteger (int64)

Last updated timestamp, UTC

Structure (JSON)
{
  "id": "string",
  "date": "string (YYYY-MM-DD)",
  "time": "string (HH:MM:SS)",
  "ticker": "string",
  "exchange": "string",
  "name": "string",
  "period": "string (Q(N))",
  "period_year": "string (YYYY)",
  "prelim": "string (B)",
  "eps_guidance_est": "string (float)",
  "eps_guidance_max": "string (float)",
  "eps_guidance_min": "string (float)",
  "eps_guidance_prior_max": "string (float)",
  "eps_guidance_prior_min": "string (float)",
  "importance": "string (N)",
  "updated": "integer (int64)"
}

ipos: object

PropertyTypeDescription
idstring

Unique ID of this entry

datestring (YYYY-MM-DD)

Date of IPO

timestring (HH:MM:SS)

Time of IPO

tickerstring

Ticker symbol for IPO

exchangestring

Exchange (NYSE, NASDAQ, etc...)

namestring

The name of the publicly traded company that the guidance data is for

pricing_datestring

date of IPO pricing

price_minstring

Minimum open price

price_maxstring

Maximum open price

deal_statusstring

status of IPO

insider_lockup_daysstring

Insider lockup period in days

insider_lockup_datestring

Insider lockup date

offering_valuestring (float)

Value of IPO

offering_sharesstring (float)

Number of shares offered in IPO

shares_from_seling_holdersstring (int)

Shares offered by holders

other_underwritersstring[]

List of other/secondary underwriter(s)

underwriter_quiet_expiration_daysstring

Underwriter quite expiration period in days

underwriter_quiet_expiration_datestring

Underwriter quite expiration date

updatedinteger (int64)

Last updated timestamp, UTC

lead_underwritersstring[]

List of lead underwriter(s)

Structure (JSON)
{
  "id": "string",
  "date": "string (YYYY-MM-DD)",
  "time": "string (HH:MM:SS)",
  "ticker": "string",
  "exchange": "string",
  "name": "string",
  "pricing_date": "string",
  "price_min": "string",
  "price_max": "string",
  "deal_status": "string",
  "insider_lockup_days": "string",
  "insider_lockup_date": "string",
  "offering_value": "string (float)",
  "offering_shares": "string (float)",
  "shares_from_seling_holders": "string (int)",
  "other_underwriters": [
    "string"
  ],
  "underwriter_quiet_expiration_days": "string",
  "underwriter_quiet_expiration_date": "string",
  "updated": "integer (int64)",
  "lead_underwriters": [
    "string"
  ]
}

ratings: object

PropertyTypeDescription
idstring

Unique ID of this entry

datestring (YYYY-MM-DD)

Date for rating

url_calendarstring (URI)

URI for analyst ratings page for this ticker on Benzinga.com

url_newsstring (URI)

URI for analyst ratings news articles for this ticker on Benzinga.com

timestring (HH:MM:SS)

Time for rating

tickerstring

Ticker symbol of company that is subject of rating

exchangestring

Exchange (NYSE, NASDAQ, etc...)

namestring

Name of company that is subject of rating

action_ptstring , x ∈ { Raises , Lowers }

Description of the change in price target for rating

action_companystring , x ∈ { Upgrades , Downgrades , Maintains , Lowers , Raises , Initiates Coverage On , Terminates Coverage On }

Description of the action for rating

rating_currentstring

The analyst's rating for the company

rating_priorstring

Prior analyst rating for the company

urlstring (URI)

URI for analyst ratings page for this ticker on Benzinga.com

importancestring , x ∈ { 1 , 2 , 3 , 4 , 5 }

Subjective Basis of How Important Event is to Market. 5 = High

updatedinteger (int64)

Last updated timestamp, UTC

analyststring

Name of the analyst firm that published the rating

Structure (JSON)
{
  "id": "string",
  "date": "string (YYYY-MM-DD)",
  "url_calendar": "string (URI)",
  "url_news": "string (URI)",
  "time": "string (HH:MM:SS)",
  "ticker": "string",
  "exchange": "string",
  "name": "string",
  "action_pt": "string",
  "action_company": "string",
  "rating_current": "string",
  "rating_prior": "string",
  "url": "string (URI)",
  "importance": "string",
  "updated": "integer (int64)",
  "analyst": "string"
}

retail: object

PropertyTypeDescription
idstring

Unique ID of this entry

datestring (YYYY-MM-DD)

Date for rating

timestring (HH:MM:SS)

Time for rating

tickerstring

Ticker symbol of company that is subject of rating

exchangestring

Exchange (NYSE, NASDAQ, etc...)

namestring

Name of company that is subject of rating

importancestring , x ∈ { 1 , 2 , 3 , 4 , 5 }

Subjective Basis of How Important Event is to Market. 5 = High

periodstring (QN) , x ∈ { Q1 , Q2 , Q3 , Q4 }

Period of the retail sales

period_yearstring (YYYY)

Year for the period of the retail sales

sssstring (float)

Same-Store Sales

updatedinteger (int64)

Last updated timestamp, UTC

Structure (JSON)
{
  "id": "string",
  "date": "string (YYYY-MM-DD)",
  "time": "string (HH:MM:SS)",
  "ticker": "string",
  "exchange": "string",
  "name": "string",
  "importance": "string",
  "period": "string (QN)",
  "period_year": "string (YYYY)",
  "sss": "string (float)",
  "updated": "integer (int64)"
}

conferenceCalls: object

PropertyTypeDescription
idstring

Unique ID of this entry

datestring (YYYY-MM-DD)

Announced Date on Calendar

timestring (HH:MM:SS)

Announced Time on Calendar

namestring

Name of company

exchangestring

Exchange (NYSE, NASDAQ, etc...)

tickerstring

Ticker symbol of company

start_timestring (HH:MM:SS)

Time of earnings conference call, in local time

phone_numstring (NNN-NNN-NNNN)

Phone number of conference call

international_numstring (NNN-NNN-NNNN)

International number to call if outside USA

reservation_numstring (NNN-NNN-NNNN)

Reservation number for conference call if avaliable

access_codestring

Access code for conference call if available

webcase_urlstring (URI)

URI of webcast for conference call if avaliable

importancestring , x ∈ { 1 , 2 , 3 , 4 , 5 }

Subjective Basis of How Important Event is to Market. 5 = High

updatedinteger (int64)

Last updated timestamp, UTC

Structure (JSON)
{
  "id": "string",
  "date": "string (YYYY-MM-DD)",
  "time": "string (HH:MM:SS)",
  "name": "string",
  "exchange": "string",
  "ticker": "string",
  "start_time": "string (HH:MM:SS)",
  "phone_num": "string (NNN-NNN-NNNN)",
  "international_num": "string (NNN-NNN-NNNN)",
  "reservation_num": "string (NNN-NNN-NNNN)",
  "access_code": "string",
  "webcase_url": "string (URI)",
  "importance": "string",
  "updated": "integer (int64)"
}