GET
/
calendar
/
ratings
curl --request GET \
  --url https://api.benzinga.com/api/v2.1/calendar/ratings \
  --header 'accept: <accept>'
{
  "ratings": [
    {
      "id": "string",
      "date": "string (YYYY-MM-DD)",
      "time": "string (HH:MM:SS)",
      "ticker": "string",
      "exchange": "string",
      "name": "string",
      "currency": "string",
      "action_pt": "string",
      "action_company": "string",
      "rating_current": "string",
      "pt_current": "string (float)",
      "adjusted_pt_current": "string (float)",
      "rating_prior": "string",
      "pt_prior": "string (float)",
      "adjusted_pt_prior": "string (float)",
      "url": "string (URL)",
      "url_calendar": "string (URL)",
      "url_news": "string (URL)",
      "analyst": "string",
      "analyst_id": "string",
      "analyst_name": "string",
      "ratings_accuracy": {
        "smart_score": "string (double)",
        "overall_success_rate": "string (double)",
        "overall_avg_return_percentile": "string (double)",
        "total_ratings_percentile": "string (double)",
        "total_ratings": "integer (int64)",
        "overall_gain_count": "integer (int64)",
        "overall_loss_count": "integer (int64)",
        "overall_average_return": "string (double)",
        "overall_stdev": "string (double)",
        "1m_gain_count": "string (double)",
        "1m_loss_count": "string (double)",
        "1m_average_return": "string (double)",
        "1m_stdev": "string (double)",
        "3m_gain_count": "string (double)",
        "3m_loss_count": "string (double)",
        "3m_average_return": "string (double)",
        "3m_stdev": "string (double)",
        "9m_gain_count": "string (double)",
        "9m_loss_count": "string (double)",
        "9m_average_return": "string (double)",
        "9m_stdev": "string (double)",
        "1y_gain_count": "string (double)",
        "1y_loss_count": "string (double)",
        "1y_average_return": "string (double)",
        "1y_stdev": "string (double)",
        "2y_gain_count": "string (double)",
        "2y_loss_count": "string (double)",
        "2y_average_return": "string (double)",
        "2y_stdev": "string (double)",
        "3y_gain_count": "string (double)",
        "3y_loss_count": "string (double)",
        "3y_average_return": "string (double)",
        "3y_stdev": "string (double)",
        "updated": "integer (int64)"
      },
      "importance": "string",
      "notes": "string",
      "updated": "integer (int64)"
    }
  ]
}
{
  "ratings": [
    {
      "id": "string",
      "date": "string (YYYY-MM-DD)",
      "time": "string (HH:MM:SS)",
      "ticker": "string",
      "exchange": "string",
      "name": "string",
      "currency": "string",
      "action_pt": "string",
      "action_company": "string",
      "rating_current": "string",
      "pt_current": "string (float)",
      "adjusted_pt_current": "string (float)",
      "rating_prior": "string",
      "pt_prior": "string (float)",
      "adjusted_pt_prior": "string (float)",
      "url": "string (URL)",
      "url_calendar": "string (URL)",
      "url_news": "string (URL)",
      "analyst": "string",
      "analyst_id": "string",
      "analyst_name": "string",
      "ratings_accuracy": {
        "smart_score": "string (double)",
        "overall_success_rate": "string (double)",
        "overall_avg_return_percentile": "string (double)",
        "total_ratings_percentile": "string (double)",
        "total_ratings": "integer (int64)",
        "overall_gain_count": "integer (int64)",
        "overall_loss_count": "integer (int64)",
        "overall_average_return": "string (double)",
        "overall_stdev": "string (double)",
        "1m_gain_count": "string (double)",
        "1m_loss_count": "string (double)",
        "1m_average_return": "string (double)",
        "1m_stdev": "string (double)",
        "3m_gain_count": "string (double)",
        "3m_loss_count": "string (double)",
        "3m_average_return": "string (double)",
        "3m_stdev": "string (double)",
        "9m_gain_count": "string (double)",
        "9m_loss_count": "string (double)",
        "9m_average_return": "string (double)",
        "9m_stdev": "string (double)",
        "1y_gain_count": "string (double)",
        "1y_loss_count": "string (double)",
        "1y_average_return": "string (double)",
        "1y_stdev": "string (double)",
        "2y_gain_count": "string (double)",
        "2y_loss_count": "string (double)",
        "2y_average_return": "string (double)",
        "2y_stdev": "string (double)",
        "3y_gain_count": "string (double)",
        "3y_loss_count": "string (double)",
        "3y_average_return": "string (double)",
        "3y_stdev": "string (double)",
        "updated": "integer (int64)"
      },
      "importance": "string",
      "notes": "string",
      "updated": "integer (int64)"
    }
  ]
}

Authorizations

token
string
queryrequired

Headers

accept
enum<string>
default: application/jsonrequired

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

Available options:
application/json

Query Parameters

fields
string

Available 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_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
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

parameters[date]
string

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

Date to query from point in time.

parameters[date_to]
string

Date to query to point in time.

parameters[tickers]
string

One 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]
enum<integer>

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

Available options:
0,
1,
2,
3,
4,
5
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.

parameters[action]
enum<string>

Filter by a specific action_company (action for rating). Note that all of these terms are precisely defined.

Available options:
Downgrades,
Maintains,
Reinstates,
Reiterates,
Upgrades,
Assumes,
Initiates Coverage On,
Terminates Coverage On,
Removes,
Suspends,
Firm Dissolved
parameters[analyst_id]
string

One or more analyst ids (analyst_id) separated by a comma.

parameters[firm_id]
string

One or more firm ids (firm_id) separated by a comma.

analyst
string

A comma separated list of analyst (person) ID's to bring back. Omitting will bring back all available analysts.

firm
string

A comma separated list of analyst firm ID's to bring back. Omitting will bring back all available firms.

Response

200 - application/json
ratings
object[]