Calendar API Reference

Free Trial ➡

This REST API returns structured data for conference calls, dividends, earnings (and future earnings dates), economics, pharmaceutical announcements, guidance, IPOs, secondary offerings, ratings, M&A activity, retail sales, and splits.

Best Practices

For optimal performance, we have a few recommendations.

Limit query, improve performance

Limiting the scope of the query will directly improve the latency of the API. This can be accomplished by using parameters such as parameters[tickers] and parameters[date], or (preferably) by using parameters[updated] for deltas.

Using Deltas

A common pattern is to use a delta to query for the latest change in a dataset. By reducing the amount of data available in the query, it will produce results with the least amount of latency and limited data an application will have to traverse.

In our case, we recommend tracking and querying by the latest updated timestamp.

One caveat to allow for some latency and second-only timestamps: when querying, set parameters[updated] to a value 5 seconds earlier than you actually want. A query may look like:

/calendar/earnings?parameters[updated]=LAGGED_TIMESTAMP Where LAGGED_TIMESTAMP is set to be five seconds less than the maximum value of the updated field in rows already pulled from our API.

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

application/json, application/xml (deprecated)

Schemes

https, http

Version

2.0.0

Authentication

token authentication

Type:
apiKey
Name:
token
In:
query

Playground

Endpoints

GET /calendar/conference-calls

Returns retail sales data

Parameters

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

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

pageintegerquery

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.

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

{
  "conference": [
    {
      "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",
      "webcast_url": "string (URL)",
      "importance": "integer",
      "notes": "string",
      "updated": "integer (int64)"
    }
  ]
}

GET /calendar/dividends

Dividends Events

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

Parameters

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

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

pageintegerquery

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.

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 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]integer , x ∈ { 0 , 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 , x ∈ { announced , ex , payable , record }query

Dividend date field to sort on (newest to oldest)

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 OK

Success

Response (200 OK)

{
  "dividends": [
    {
      "id": "string",
      "date": "string (YYYY-DD-MM)",
      "notes": "string",
      "updated": "integer",
      "ticker": "string",
      "name": "string",
      "exchange": "string",
      "currency": "string",
      "frequency": "integer",
      "dividend": "string (double)",
      "dividend_prior": "string (double)",
      "dividend_type": "string",
      "dividend_yield": "string (double)",
      "ex_dividend_date": "string (YYYY-DD-MM)",
      "payable_date": "string (YYYY-DD-MM)",
      "record_date": "string (YYYY-DD-MM)",
      "importance": "integer"
    }
  ]
}

GET /calendar/earnings

Returns the earnings data

Parameters

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

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

pageintegerquery

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.

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[date_sort]string , x ∈ { date }query

Field sort option for earnings calendar. Apply :desc, :asc for sort order.

parameters[tickers]string (csv)query

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]integer , x ∈ { 0 , 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 OK

success

Response (200 OK)

{
  "earnings": [
    {
      "id": "string",
      "date": "string (YYYY-DD-MM)",
      "date_confirmed": "string (1/0)",
      "time": "string (HH:MM:SS)",
      "ticker": "string",
      "exchange": "string",
      "name": "string",
      "currency": "string",
      "period": "string",
      "period_year": "integer",
      "eps_type": "string",
      "eps": "string (double)",
      "eps_est": "string (double)",
      "eps_prior": "string (double)",
      "eps_surprise": "string (double)",
      "eps_surprise_percent": "string (double)",
      "revenue_type": "string",
      "revenue": "string (integer)",
      "revenue_est": "string (integer)",
      "revenue_prior": "string (integer)",
      "revenue_surprise": "string (integer)",
      "revenue_surprise_percent": "string (double)",
      "importance": "integer",
      "notes": "string",
      "updated": "integer"
    }
  ]
}

GET /calendar/economics

Returns the economic calendar data

Parameters

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

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

pageintegerquery

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.

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[importance]integer , x ∈ { 0 , 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 OK

success

Response (200 OK)

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

GET /calendar/fda

FDA approvals, clinical trials, and PDUFA dates

Returns FDA approvals, clinical trials, and PDUFA dates

Parameters

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

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

pageintegerquery

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.

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[date_search_field]string , x ∈ { announced , target }query

Date to filter and sort calendar by. Default is announced.

parameters[date_search_strict]booleanquery

Some 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]string (csv)query

One 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]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)

{
  "fda": [
    {
      "id": "string",
      "event_type": "string",
      "date": "string (YYYY-DD-MM)",
      "time": "string (HH:MM:SS)",
      "companies": [
        {
          "id": "string",
          "name": "string",
          "cik": "string (10-digit integer)",
          "securities": [
            {
              "exchange": "string",
              "symbol": "string"
            }
          ]
        }
      ],
      "drug": {
        "id": "integer",
        "name": "string",
        "indication_symptom": [
          "string"
        ],
        "generic": "boolean"
      },
      "status": "string",
      "nic_number": "string (NCTXXXXXXXX)",
      "target_date": "string (YYYY-MM-DD, YYYY-MM, YYYY-Q[1-4], YYYY-H[1-2], or YYYY-[EARLY, MID, LATE])",
      "outcome_brief": "string",
      "outcome": "string",
      "commentary": "string",
      "source_type": "string",
      "source_link": "string",
      "notes": "string",
      "created": "integer",
      "updated": "integer"
    }
  ]
}

GET /calendar/guidance

Returns guidance data

Parameters

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

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

pageintegerquery

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.

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 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]integer , x ∈ { 0 , 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[is_primary]string , x ∈ { Y , N , All }query

Determines if guidance returned is primary, secondary or all. Default set to Y.

Responses

CodeModelDescription
200 OK

success

Response (200 OK)

{
  "guidance": [
    {
      "id": "string",
      "date": "string (YYYY-MM-DD)",
      "time": "string (HH:MM:SS)",
      "ticker": "string",
      "exchange": "string",
      "name": "string",
      "currency": "string",
      "period": "string",
      "period_year": "integer (YYYY)",
      "prelim": "string",
      "is_primary": "string",
      "eps_type": "string",
      "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)",
      "revenue_guidance_est": "string (float)",
      "revenue_guidance_max": "string (float)",
      "revenue_guidance_min": "string (float)",
      "revenue_guidance_prior_max": "string (float)",
      "revenue_guidance_prior_min": "string (float)",
      "revenue_type": "string",
      "importance": "integer",
      "notes": "string",
      "updated": "integer (int64)"
    }
  ]
}

GET /calendar/ipos

Returns ipo data

Parameters

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

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

pageintegerquery

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.

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[ipo_type]string (csv)query

One or more IPO types separated by a comma. Example:

Ordinary Shares,SPAC

parameters[tickers]string (csv)query

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

{
  "ipos": [
    {
      "id": "string",
      "date": "string (YYYY-MM-DD, YYYY-QN, YYYY-MM, YYYY-HN, YYYY)",
      "time": "string (HH:MM:SS)",
      "ticker": "string",
      "exchange": "string",
      "name": "string",
      "open_date_verified": "boolean",
      "pricing_date": "string (YYYY-MM-DD)",
      "currency": "string",
      "price_min": "string (double)",
      "price_max": "string (double)",
      "price_public_offering": "string (double)",
      "price_open": "string (double)",
      "deal_status": "string",
      "ipo_type": "string",
      "insider_lockup_days": "integer",
      "insider_lockup_date": "string (YYYY-MM-DD)",
      "offering_value": "integer (int64)",
      "offering_shares": "integer (int64)",
      "shares_outstanding": "integer",
      "lead_underwriters": [
        "string"
      ],
      "other_underwriters": [
        "string"
      ],
      "underwriter_quiet_expiration_days": "integer",
      "underwriter_quiet_expiration_date": "string (YYYY-MM-DD)",
      "notes": "string",
      "updated": "integer (int64)"
    }
  ]
}

GET /calendar/offerings

Returns Secondary Offering data

Parameters

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

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

pageintegerquery

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.

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 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]integer , x ∈ { 0 , 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 OKofferings

success

Response (200 OK)

[
  {
    "id": "string",
    "date": "string (YYYY-MM-DD, YYYY-QN, YYYY-MM, YYYY-HN, YYYY)",
    "time": "string (HH:MM:SS)",
    "ticker": "string",
    "exchange": "string",
    "name": "string",
    "currency": "string",
    "shelf": "boolean",
    "price": "string (double)",
    "proceeds": "string (double)",
    "number_shares": "integer",
    "importance": "integer",
    "notes": "string",
    "updated": "integer (int64)"
  }
]

GET /calendar/ratings

Returns analyst ratings data

Parameters

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

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

fieldsstring (csv)query

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
pageintegerquery

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.

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 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]integer , x ∈ { 0 , 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 ∈ { Downgrades , Maintains , Reinstates , Reiterates , Upgrades , Assumes , Initiates Coverage On , Terminates Coverage On , Removes , Suspends , Firm Dissolved }query

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

parameters[analyst_id]string (csv)query

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

parameters[firm_id]string (csv)query

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

analyststring (csv)query

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

firmstring (csv)query

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

Responses

CodeModelDescription
200 OK

success

Response (200 OK)

{
  "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)",
      "rating_prior": "string",
      "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)"
    }
  ]
}

GET /calendar/ma

Returns the mergers and acquisitions data

Parameters

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

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

pageintegerquery

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.

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 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]integer , x ∈ { 0 , 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[date_sort]string , x ∈ { expected , completed , announced }query

M&A date field to sort on (newest to oldest for expected and completed; oldest to newest for announced)

Responses

CodeModelDescription
200 OK

success

Response (200 OK)

{
  "ma": [
    {
      "id": "string",
      "date": "string (YYYY-MM-DD)",
      "date_expected": "string (YYYY-MM-DD, YYYY-QN, YYYY-MM)",
      "date_completed": "string (YYYY-MM-DD)",
      "acquirer_ticker": "string",
      "acquirer_exchange": "string",
      "acquirer_name": "string",
      "target_ticker": "string",
      "target_exchange": "string",
      "target_name": "string",
      "currency": "string",
      "deal_type": "string",
      "deal_size": "string (double)",
      "deal_payment_type": "string",
      "deal_status": "string",
      "deal_terms_extra": "string",
      "importance": "integer",
      "notes": "string",
      "updated": "integer (int64)"
    }
  ]
}

GET /calendar/retail

Returns retail sales data

Parameters

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

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

pageintegerquery

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.

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 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]integer , x ∈ { 0 , 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 OK

success

Response (200 OK)

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

GET /calendar/splits

Returns the splits calendar data

Parameters

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

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

pageintegerquery

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.

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[date_search_field]string , x ∈ { announced , ex }query

Date to filter and sort calendar by. Default is announced.

parameters[tickers]string (csv)query

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]integer , x ∈ { 0 , 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 OK

success

Response (200 OK)

{
  "splits": [
    {
      "id": "string",
      "updated": "integer",
      "date_announced": "string (YYYY-DD-MM)",
      "ticker": "string",
      "exchange": "string",
      "ratio": "string (x:y)",
      "optionable": "boolean",
      "date_ex": "string (YYYY-MM-DD)",
      "date_recorded": "string (YYYY-MM-DD)",
      "date_distribution": "string (YYYY-MM-DD)",
      "importance": "integer",
      "notes": "string"
    }
  ]
}

GET /calendar-removed

Returns the removed calendar data

Parameters

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

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

pageintegerquery

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.

pageSizeintegerquery

Number of results returned. Limit 1000. Default 50.

typestring , x ∈ { ratings , earnings , guidance , ipos , offerings , economics , ma , retail , splits , dividends , conference calls }query

Calendar type

updatedinteger (int64)query

Records removed after 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)

{
  "removed": [
    {
      "id": "string",
      "type": "string",
      "updated": "integer (int64)"
    }
  ]
}

GET /calendar/ratings/analysts

Returns the available firms providing analyst ratings

Parameters

NameTypeLocationDescription
fieldsstring (csv)query

Available fields:

  • id
  • name_first
  • name_last
  • name_full
  • firm_id
  • firm_name
  • ratings_accuracy
  • updated

Default fields:

  • id
  • name_full
  • firm_id
  • firm_name
analyststring (csv)query

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

pageintegerquery

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.

pageSizeintegerquery

Number of results returned. Limit 1000. Default 50.

updatedinteger (int64)query

Records removed after 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)

{
  "removed": [
    {
      "id": "string",
      "firm_id": "string",
      "firm_name": "string",
      "name_first": "string",
      "name_last": "string",
      "name_full": "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)"
      },
      "updated": "integer (int64)"
    }
  ]
}

GET /calendar/ratings/firms

Returns the available firms providing analyst ratings

Parameters

NameTypeLocationDescription
fieldsstring (csv)query

Available fields:

  • id
  • name
  • currency
  • homepage
  • updated

Default fields:

  • id
  • name
firmstring (csv)query

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

pageintegerquery

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.

pageSizeintegerquery

Number of results returned. Limit 1000. Default 50.

updatedinteger (int64)query

Records removed after 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)

{
  "analyst_ratings_firm": [
    {
      "id": "string",
      "currency": "string",
      "homepage": "string",
      "name": "string",
      "updated": "integer (int64)"
    }
  ]
}

Models

analyst-ratings-analyst: object

PropertyTypeDescription
idstring

Id of the analyst

firm_idstring

Id of the analyst firm

firm_namestring

Firm name of the analyst

name_firststring

Analyst first name

name_laststring

Analyst last name

name_fullstring

Analyst full name for display

ratings_accuracyobject

Analyst accuracy scores

ratings_accuracy.smart_scorestring (double)

A weighted average of the total_ratings_percentile, overall_avg_return_percentile, and overall_success_rate

ratings_accuracy.overall_success_ratestring (double)

The percentage of gain/loss ratings that resulted in a gain overall

ratings_accuracy.overall_avg_return_percentilestring (double)

The percentile of this analyst’s overall average return per rating in comparison to other analysts' overall average returns per rating

ratings_accuracy.total_ratings_percentilestring (double)

The percentile of this analyst’s total number of ratings in comparison to the total number of ratings published by all other analysts

ratings_accuracy.total_ratingsinteger (int64)

Number of recommendations made by this analyst

ratings_accuracy.overall_gain_countinteger (int64)

The number of ratings that have gained value since the date of recommendation

ratings_accuracy.overall_loss_countinteger (int64)

The number of ratings that have lost value since the date of recommendation

ratings_accuracy.overall_average_returnstring (double)

The average percent price difference per rating since the date of recommendation

ratings_accuracy.overall_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings since the date of recommendation

ratings_accuracy.1m_gain_countstring (double)

The number of ratings that have gained value over the last month

ratings_accuracy.1m_loss_countstring (double)

The number of ratings that have lost value over the last month

ratings_accuracy.1m_average_returnstring (double)

The average percent price difference per rating over the last month

ratings_accuracy.1m_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last month

ratings_accuracy.3m_gain_countstring (double)

The number of ratings that have gained value over the last three months

ratings_accuracy.3m_loss_countstring (double)

The number of ratings that have lost value over the last three months

ratings_accuracy.3m_average_returnstring (double)

The average percent price difference per rating over the last three months

ratings_accuracy.3m_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last three months

ratings_accuracy.9m_gain_countstring (double)

The number of ratings that have gained value over the last nine months

ratings_accuracy.9m_loss_countstring (double)

The number of ratings that have lost value over the last nine months

ratings_accuracy.9m_average_returnstring (double)

The average percent price difference per rating over the last nine months

ratings_accuracy.9m_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last nine months

ratings_accuracy.1y_gain_countstring (double)

The number of ratings that have gained value over the last year (TTM)

ratings_accuracy.1y_loss_countstring (double)

The number of ratings that have lost value over the last year (TTM)

ratings_accuracy.1y_average_returnstring (double)

The average percent price difference per rating over the last year (TTM)

ratings_accuracy.1y_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last year (TTM)

ratings_accuracy.2y_gain_countstring (double)

The number of ratings that have gained value over the last two years

ratings_accuracy.2y_loss_countstring (double)

The number of ratings that have lost value over the last two years

ratings_accuracy.2y_average_returnstring (double)

The average percent price difference per rating over the last two years

ratings_accuracy.2y_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last two years

ratings_accuracy.3y_gain_countstring (double)

The number of ratings that have gained value over the last three years

ratings_accuracy.3y_loss_countstring (double)

The number of ratings that have lost value over the last three years

ratings_accuracy.3y_average_returnstring (double)

The average percent price difference per rating over the last three years

ratings_accuracy.3y_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last three years

ratings_accuracy.updatedinteger (int64)

Last update timstamp in UTC Unix epoch timestamp (seconds)

updatedinteger (int64)

Last update timstamp in UTC Unix epoch timestamp (seconds)

Structure (JSON)
{
  "id": "string",
  "firm_id": "string",
  "firm_name": "string",
  "name_first": "string",
  "name_last": "string",
  "name_full": "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)"
  },
  "updated": "integer (int64)"
}

ratings_accuracy: object

Analyst accuracy scores

PropertyTypeDescription
smart_scorestring (double)

A weighted average of the total_ratings_percentile, overall_avg_return_percentile, and overall_success_rate

overall_success_ratestring (double)

The percentage of gain/loss ratings that resulted in a gain overall

overall_avg_return_percentilestring (double)

The percentile of this analyst’s overall average return per rating in comparison to other analysts' overall average returns per rating

total_ratings_percentilestring (double)

The percentile of this analyst’s total number of ratings in comparison to the total number of ratings published by all other analysts

total_ratingsinteger (int64)

Number of recommendations made by this analyst

overall_gain_countinteger (int64)

The number of ratings that have gained value since the date of recommendation

overall_loss_countinteger (int64)

The number of ratings that have lost value since the date of recommendation

overall_average_returnstring (double)

The average percent price difference per rating since the date of recommendation

overall_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings since the date of recommendation

1m_gain_countstring (double)

The number of ratings that have gained value over the last month

1m_loss_countstring (double)

The number of ratings that have lost value over the last month

1m_average_returnstring (double)

The average percent price difference per rating over the last month

1m_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last month

3m_gain_countstring (double)

The number of ratings that have gained value over the last three months

3m_loss_countstring (double)

The number of ratings that have lost value over the last three months

3m_average_returnstring (double)

The average percent price difference per rating over the last three months

3m_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last three months

9m_gain_countstring (double)

The number of ratings that have gained value over the last nine months

9m_loss_countstring (double)

The number of ratings that have lost value over the last nine months

9m_average_returnstring (double)

The average percent price difference per rating over the last nine months

9m_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last nine months

1y_gain_countstring (double)

The number of ratings that have gained value over the last year (TTM)

1y_loss_countstring (double)

The number of ratings that have lost value over the last year (TTM)

1y_average_returnstring (double)

The average percent price difference per rating over the last year (TTM)

1y_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last year (TTM)

2y_gain_countstring (double)

The number of ratings that have gained value over the last two years

2y_loss_countstring (double)

The number of ratings that have lost value over the last two years

2y_average_returnstring (double)

The average percent price difference per rating over the last two years

2y_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last two years

3y_gain_countstring (double)

The number of ratings that have gained value over the last three years

3y_loss_countstring (double)

The number of ratings that have lost value over the last three years

3y_average_returnstring (double)

The average percent price difference per rating over the last three years

3y_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last three years

updatedinteger (int64)

Last update timstamp in UTC Unix epoch timestamp (seconds)

Structure (JSON)
{
  "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)"
}

analyst-ratings-firm: object

PropertyTypeDescription
idstring

Id of the analyst firm

currencystring

Default currency of the analyst firm

homepagestring

URL for the analyst firm

namestring

Analyst firm name

updatedinteger (int64)

Last update timstamp in UTC Unix epoch timestamp (seconds)

Structure (JSON)
{
  "id": "string",
  "currency": "string",
  "homepage": "string",
  "name": "string",
  "updated": "integer (int64)"
}

dividends: object

PropertyTypeDescription
idstring

Unique ID of this entry

datestring (YYYY-DD-MM)

Announced Date on calendar

notesstring

Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML.

updatedinteger

Last updated timestamp, UTC

tickerstring

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

namestring

Name of security

exchangestring

Exchange (NYSE, NASDAQ, etc...)

currencystring

Currency the data is denominated in

frequencyinteger

Frequency of the dividend

dividendstring (double)

Dividend value. Expected value is a double if set or empty if null.

dividend_priorstring (double)

Period prior dividend value. Expected value is a double if set or empty if null.

dividend_typestring

Type of dividend

dividend_yieldstring (double)

Yield of dividend. Expected value is a double if set or empty if null.

ex_dividend_datestring (YYYY-DD-MM)

Dividend Ex Date

payable_datestring (YYYY-DD-MM)

Dividend Payable Date

record_datestring (YYYY-DD-MM)

Dividend Recorded Date

importanceinteger , x ∈ { 0 , 1 , 2 , 3 , 4 , 5 }

Subjective basis of how important event is to market. 5 = high

Structure (JSON)
{
  "id": "string",
  "date": "string (YYYY-DD-MM)",
  "notes": "string",
  "updated": "integer",
  "ticker": "string",
  "name": "string",
  "exchange": "string",
  "currency": "string",
  "frequency": "integer",
  "dividend": "string (double)",
  "dividend_prior": "string (double)",
  "dividend_type": "string",
  "dividend_yield": "string (double)",
  "ex_dividend_date": "string (YYYY-DD-MM)",
  "payable_date": "string (YYYY-DD-MM)",
  "record_date": "string (YYYY-DD-MM)",
  "importance": "integer"
}

earnings: object

PropertyTypeDescription
idstring-
datestring (YYYY-DD-MM)

Announced Date on Calendar

date_confirmedstring (1/0)

If the report date was confirmed (vs est)

timestring (HH:MM:SS)

Announced Time on Calendar, 24hr format

tickerstring

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

exchangestring

Exchange (NYSE, NASDAQ, etc...)

namestring

Name of security

currencystring

Currency the data is denominated in

periodstring , x ∈ { Q1 , Q2 , Q3 , Q4 , FY , H1 , H2 }

Period of the earnings actual

period_yearinteger

Period Year of the earnings actual

eps_typestring , x ∈ { Adj , GAAP , FFO }

EPS Type

epsstring (double)

Comparable and Adjusted Earnings Per Share

eps_eststring (double)

Adjusted EPS Consensus Aggregate Analyst Estimate

eps_priorstring (double)

Adjusted EPS from Prior Period

eps_surprisestring (double)

EPS deviation from estimate

eps_surprise_percentstring (double)

Deviation from estimate as percentage

revenue_typestring , x ∈ { Adj , GAAP , FFO }

Revenue Type

revenuestring (integer)

Revenue

revenue_eststring (integer)

Revenue estimate

revenue_priorstring (integer)

Revenue value for previous period

revenue_surprisestring (integer)

Revenue deviation from estimate

revenue_surprise_percentstring (double)

Deviation from estimate as percentage

importanceinteger , x ∈ { 0 , 1 , 2 , 3 , 4 , 5 }

Subjective basis of how important event is to market. 5 = high

notesstring

Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML.

updatedinteger

Last updated timestamp, UTC

Structure (JSON)
{
  "id": "string",
  "date": "string (YYYY-DD-MM)",
  "date_confirmed": "string (1/0)",
  "time": "string (HH:MM:SS)",
  "ticker": "string",
  "exchange": "string",
  "name": "string",
  "currency": "string",
  "period": "string",
  "period_year": "integer",
  "eps_type": "string",
  "eps": "string (double)",
  "eps_est": "string (double)",
  "eps_prior": "string (double)",
  "eps_surprise": "string (double)",
  "eps_surprise_percent": "string (double)",
  "revenue_type": "string",
  "revenue": "string (integer)",
  "revenue_est": "string (integer)",
  "revenue_prior": "string (integer)",
  "revenue_surprise": "string (integer)",
  "revenue_surprise_percent": "string (double)",
  "importance": "integer",
  "notes": "string",
  "updated": "integer"
}

fda: object

PropertyTypeDescription
idstring

Unique ID of this entry

event_typestring , x ∈ { clinical_trial , approval_fda , approval_foreign , pdufa_date }

Specifies which type of event the row represents.

datestring (YYYY-DD-MM)

Date on which Benzinga received the information

timestring (HH:MM:SS)

Time at which Benzinga received the information

companiesobject[]

Companies developing the drug

companies[].idstring

Company ID

companies[].namestring

Company name

companies[].cikstring (10-digit integer)

Company primary CIK

companies[].securitiesobject[]

Company securities

companies[].securities[].exchangestring

Exchange on which the security is listed

companies[].securities[].symbolstring

Ticker symbol for the security

drugobject-
drug.idinteger

Internal ID for the drug

drug.namestring

Name of the drug

drug.indication_symptomstring[]

Indications/symptoms

drug.genericboolean

Is this a generic drug?

statusstring

The announced status of the drug

nic_numberstring (NCTXXXXXXXX)

The US National Library of Medicine's individual identifier for each clinical trial

target_datestring (YYYY-MM-DD, YYYY-MM, YYYY-Q[1-4], YYYY-H[1-2], or YYYY-[EARLY, MID, LATE])

The announced target date

outcome_briefstring , x ∈ { Planned to Submit , Filing Accepted , Updated Application , Planned Meeting , Announced Clearance to Study , Concluded Enrollment , Initiated Study , Study Progressed , Concluded Study , Temporarily Suspended , Approved to Commence , Decision Deferred , Provided Update , Data Release Scheduled , Published Results , Received Use Authorization }

The significance/outcome of the announcement, categorized

outcomestring

The significance/outcome of the announcement

commentarystring

Additional information beyond the few-sentence outcome

source_typestring , x ∈ { Press Release , FDA Website , Other }

The type of source from which this data was obtained

source_linkstring

The URL of the source

notesstring

Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML.

createdinteger

Object creation Unix timestamp, UTC

updatedinteger

Last updated Unix timestamp, UTC

Structure (JSON)
{
  "id": "string",
  "event_type": "string",
  "date": "string (YYYY-DD-MM)",
  "time": "string (HH:MM:SS)",
  "companies": [
    {
      "id": "string",
      "name": "string",
      "cik": "string (10-digit integer)",
      "securities": [
        {
          "exchange": "string",
          "symbol": "string"
        }
      ]
    }
  ],
  "drug": {
    "id": "integer",
    "name": "string",
    "indication_symptom": [
      "string"
    ],
    "generic": "boolean"
  },
  "status": "string",
  "nic_number": "string (NCTXXXXXXXX)",
  "target_date": "string (YYYY-MM-DD, YYYY-MM, YYYY-Q[1-4], YYYY-H[1-2], or YYYY-[EARLY, MID, LATE])",
  "outcome_brief": "string",
  "outcome": "string",
  "commentary": "string",
  "source_type": "string",
  "source_link": "string",
  "notes": "string",
  "created": "integer",
  "updated": "integer"
}

splits: object

PropertyTypeDescription
idstring

Unique ID of this entry

updatedinteger

Last updated timestamp, UTC

date_announcedstring (YYYY-DD-MM)

Announced Date on calendar (formerly labeled as date in our docs).

tickerstring

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

exchangestring

Exchange (NYSE, NASDAQ, etc...)

ratiostring (x:y)

Ratio of the split

optionableboolean

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

importanceinteger , x ∈ { 0 , 1 , 2 , 3 , 4 , 5 }

Subjective basis of how important event is to market. 5 = high

notesstring

Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML.

Structure (JSON)
{
  "id": "string",
  "updated": "integer",
  "date_announced": "string (YYYY-DD-MM)",
  "ticker": "string",
  "exchange": "string",
  "ratio": "string (x:y)",
  "optionable": "boolean",
  "date_ex": "string (YYYY-MM-DD)",
  "date_recorded": "string (YYYY-MM-DD)",
  "date_distribution": "string (YYYY-MM-DD)",
  "importance": "integer",
  "notes": "string"
}

economics: object

PropertyTypeDescription
idstring

Unique identifier for each data point

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

Announced Time on Calendar, 24hr format

countrystring

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

event_namestring

Economic Event

event_periodstring

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

period_yearinteger (YYYY)

Period Year

actualstring (float)

Value of economic indicator

actual_tstring

Unit for actual field

consensusstring (float)

Estimate for actual field

consensus_tstring

Unit for consensus field

priorstring (float)

Value of actual field for previous period

prior_tstring

Unit for prior field

importanceinteger , x ∈ { 0 , 1 , 2 , 3 , 4 , 5 }

Subjective basis of how important event is to market. 5 = High

updatedinteger

Last updated timestamp, UTC

descriptionstring

Event Description

Structure (JSON)
{
  "id": "string",
  "date": "string (YYYY-MM-DD)",
  "time": "string (HH:MM:SS)",
  "country": "string",
  "event_name": "string",
  "event_period": "string",
  "period_year": "integer (YYYY)",
  "actual": "string (float)",
  "actual_t": "string",
  "consensus": "string (float)",
  "consensus_t": "string",
  "prior": "string (float)",
  "prior_t": "string",
  "importance": "integer",
  "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

currencystring

Currency the data is denominated in

periodstring , x ∈ { Q1 , Q2 , Q3 , Q4 , FY }

Period within-year of the guidance

period_yearinteger (YYYY)

Period year of the guidance

prelimstring , x ∈ { Y , N }

Yes or No for if guidance is a preliminary earnings report

is_primarystring , x ∈ { Y , N , All }

Specifies type of guidance returned - primary, secondary or all

eps_typestring , x ∈ { Adj , GAAP , FFO }

Reported EPS Type can be Adjusted, GAAP or FFO. FFO is only used for REITs.

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

revenue_guidance_eststring (float)

Revenue guidance estimate

revenue_guidance_maxstring (float)

Revenue guidance max

revenue_guidance_minstring (float)

Revenue guidance min

revenue_guidance_prior_maxstring (float)

Revenue guidance max from previous period

revenue_guidance_prior_minstring (float)

Revenue guidance min from previous period

revenue_typestring , x ∈ { Adj , GAAP , FFO }

Revenue Type

importanceinteger , x ∈ { 0 , 1 , 2 , 3 , 4 , 5 }

Subjective basis of how important event is to market. 5 = high

notesstring

Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML.

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",
  "currency": "string",
  "period": "string",
  "period_year": "integer (YYYY)",
  "prelim": "string",
  "is_primary": "string",
  "eps_type": "string",
  "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)",
  "revenue_guidance_est": "string (float)",
  "revenue_guidance_max": "string (float)",
  "revenue_guidance_min": "string (float)",
  "revenue_guidance_prior_max": "string (float)",
  "revenue_guidance_prior_min": "string (float)",
  "revenue_type": "string",
  "importance": "integer",
  "notes": "string",
  "updated": "integer (int64)"
}

ipos: object

PropertyTypeDescription
idstring

Unique ID of this entry

datestring (YYYY-MM-DD, YYYY-QN, YYYY-MM, YYYY-HN, YYYY)

Expected (Actual) IPO Open Date

timestring (HH:MM:SS)

Time of row entry

tickerstring

Ticker symbol for IPO

exchangestring

Exchange (NYSE, NASDAQ, etc...)

namestring

The name of the IPO company

open_date_verifiedboolean

Is the IPO open date verified?

pricing_datestring (YYYY-MM-DD)

date of IPO pricing

currencystring

Currency the data is denominated in

price_minstring (double)

Minimum open price

price_maxstring (double)

Maximum open price

price_public_offeringstring (double)

Price at which the company sells its shares to investors during an IPO

price_openstring (double)

Price at open

deal_statusstring , x ∈ { Rumored , Initial Filing , Amended , Priced , Closed , Postponed , Withdrawn }

status of IPO

ipo_typestring , x ∈ { Ordinary Shares , Depository Receipt , Unit , SPAC Unit , SPAC , MandA , Direct Listing , }

Type of IPO

insider_lockup_daysinteger

Insider lockup period in days

insider_lockup_datestring (YYYY-MM-DD)

Insider lockup date

offering_valueinteger (int64)

Value of IPO (offering_shares multiplied by the public offering price)

offering_sharesinteger (int64)

Number of shares offered in IPO

shares_outstandinginteger

Temporarily unavailable. If pre-IPO shares outstanding is an important data field for you, please let us know.

lead_underwritersstring[]

List of lead underwriter(s)

other_underwritersstring[]

List of other/secondary underwriter(s)

underwriter_quiet_expiration_daysinteger

Underwriter quite expiration period in days

underwriter_quiet_expiration_datestring (YYYY-MM-DD)

Underwriter quite expiration date

notesstring

Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML.

updatedinteger (int64)

Last updated timestamp, UTC

Structure (JSON)
{
  "id": "string",
  "date": "string (YYYY-MM-DD, YYYY-QN, YYYY-MM, YYYY-HN, YYYY)",
  "time": "string (HH:MM:SS)",
  "ticker": "string",
  "exchange": "string",
  "name": "string",
  "open_date_verified": "boolean",
  "pricing_date": "string (YYYY-MM-DD)",
  "currency": "string",
  "price_min": "string (double)",
  "price_max": "string (double)",
  "price_public_offering": "string (double)",
  "price_open": "string (double)",
  "deal_status": "string",
  "ipo_type": "string",
  "insider_lockup_days": "integer",
  "insider_lockup_date": "string (YYYY-MM-DD)",
  "offering_value": "integer (int64)",
  "offering_shares": "integer (int64)",
  "shares_outstanding": "integer",
  "lead_underwriters": [
    "string"
  ],
  "other_underwriters": [
    "string"
  ],
  "underwriter_quiet_expiration_days": "integer",
  "underwriter_quiet_expiration_date": "string (YYYY-MM-DD)",
  "notes": "string",
  "updated": "integer (int64)"
}

offerings: object

PropertyTypeDescription
idstring

Unique ID of this entry

datestring (YYYY-MM-DD, YYYY-QN, YYYY-MM, YYYY-HN, YYYY)

Date of offering issuance

timestring (HH:MM:SS)

Time of offering issuance

tickerstring

Ticker symbol for offering

exchangestring

Exchange (NYSE, NASDAQ, etc...)

namestring

The name of the company

currencystring

The currency of the offering

shelfboolean

If the offer is a Shelf. True if securities are sold in portion over a longer period. False if securities are sold at the initial date of offering.

pricestring (double)

The offering price

proceedsstring (double)

The total value of the offering

number_sharesinteger

The number of shares in the offering

importanceinteger

Benzinga assigned score for how important the event is

notesstring

Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML.

updatedinteger (int64)

Last updated timestamp, UTC

Structure (JSON)
{
  "id": "string",
  "date": "string (YYYY-MM-DD, YYYY-QN, YYYY-MM, YYYY-HN, YYYY)",
  "time": "string (HH:MM:SS)",
  "ticker": "string",
  "exchange": "string",
  "name": "string",
  "currency": "string",
  "shelf": "boolean",
  "price": "string (double)",
  "proceeds": "string (double)",
  "number_shares": "integer",
  "importance": "integer",
  "notes": "string",
  "updated": "integer (int64)"
}

ma: object

PropertyTypeDescription
idstring

Undque ID of this entry

datestring (YYYY-MM-DD)

Date of deal announcment

date_expectedstring (YYYY-MM-DD, YYYY-QN, YYYY-MM)

Date deal is expected to complete

date_completedstring (YYYY-MM-DD)

Date of deal completion

acquirer_tickerstring

Ticker symbol of acquiring company

acquirer_exchangestring

Exchange for the acquirer ticker

acquirer_namestring

Name of acquiring company

target_tickerstring

Ticker symbol of target company

target_exchangestring

Exchange for the target ticker

target_namestring

Name of the target company

currencystring

Currency the data is denominated in

deal_typestring , x ∈ { Acquisition , Merger , Asset Sale }

Type of deal

deal_sizestring (double)

Aggregate deal value

deal_payment_typestring , x ∈ { Cash , Stock , Cash & Stock }

Deal payment type

deal_statusstring , x ∈ { Rumored , Announced , Regulatory Review , Completed , Canceled }

Deal status

deal_terms_extrastring

Any additional relevant terms

importanceinteger

Benzinga assigned score for how important entry is

notesstring

Any supplimentarty details. Used in conjunction with Deal Terms for non term notes

updatedinteger (int64)

Last updated timestamp, UTC

Structure (JSON)
{
  "id": "string",
  "date": "string (YYYY-MM-DD)",
  "date_expected": "string (YYYY-MM-DD, YYYY-QN, YYYY-MM)",
  "date_completed": "string (YYYY-MM-DD)",
  "acquirer_ticker": "string",
  "acquirer_exchange": "string",
  "acquirer_name": "string",
  "target_ticker": "string",
  "target_exchange": "string",
  "target_name": "string",
  "currency": "string",
  "deal_type": "string",
  "deal_size": "string (double)",
  "deal_payment_type": "string",
  "deal_status": "string",
  "deal_terms_extra": "string",
  "importance": "integer",
  "notes": "string",
  "updated": "integer (int64)"
}

ratings: 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

currencystring

Currency the data is denominated in

action_ptstring , x ∈ { Announces , Maintains , Lowers , Raises , Removes }

Description of the change in price target from firm's last price target

action_companystring , x ∈ { Downgrades , Maintains , Reinstates , Reiterates , Upgrades , Assumes , Initiates Coverage On , Terminates Coverage On , Removes , Suspends , Firm Dissolved }

Description of the change in rating from firm's last rating. Note that all of these terms are precisely defined.

rating_currentstring

The analyst's rating for the company

pt_currentstring (float)

Analyst's current price target

rating_priorstring

Prior analyst rating for the company

pt_priorstring (float)

Analyst's prior price target

urlstring (URL)

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

url_calendarstring (URL)

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

url_newsstring (URL)

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

analyststring

Name of the analyst firm that published the rating

analyst_idstring

Id of the analyst

analyst_namestring

Name of the analyst (person) that published the rating

ratings_accuracyobject

Analyst accuracy scores

ratings_accuracy.smart_scorestring (double)

A weighted average of the total_ratings_percentile, overall_avg_return_percentile, and overall_success_rate

ratings_accuracy.overall_success_ratestring (double)

The percentage of gain/loss ratings that resulted in a gain overall

ratings_accuracy.overall_avg_return_percentilestring (double)

The percentile of this analyst’s overall average return per rating in comparison to other analysts' overall average returns per rating

ratings_accuracy.total_ratings_percentilestring (double)

The percentile of this analyst’s total number of ratings in comparison to the total number of ratings published by all other analysts

ratings_accuracy.total_ratingsinteger (int64)

Number of recommendations made by this analyst

ratings_accuracy.overall_gain_countinteger (int64)

The number of ratings that have gained value since the date of recommendation

ratings_accuracy.overall_loss_countinteger (int64)

The number of ratings that have lost value since the date of recommendation

ratings_accuracy.overall_average_returnstring (double)

The average percent price difference per rating since the date of recommendation

ratings_accuracy.overall_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings since the date of recommendation

ratings_accuracy.1m_gain_countstring (double)

The number of ratings that have gained value over the last month

ratings_accuracy.1m_loss_countstring (double)

The number of ratings that have lost value over the last month

ratings_accuracy.1m_average_returnstring (double)

The average percent price difference per rating over the last month

ratings_accuracy.1m_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last month

ratings_accuracy.3m_gain_countstring (double)

The number of ratings that have gained value over the last three months

ratings_accuracy.3m_loss_countstring (double)

The number of ratings that have lost value over the last three months

ratings_accuracy.3m_average_returnstring (double)

The average percent price difference per rating over the last three months

ratings_accuracy.3m_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last three months

ratings_accuracy.9m_gain_countstring (double)

The number of ratings that have gained value over the last nine months

ratings_accuracy.9m_loss_countstring (double)

The number of ratings that have lost value over the last nine months

ratings_accuracy.9m_average_returnstring (double)

The average percent price difference per rating over the last nine months

ratings_accuracy.9m_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last nine months

ratings_accuracy.1y_gain_countstring (double)

The number of ratings that have gained value over the last year (TTM)

ratings_accuracy.1y_loss_countstring (double)

The number of ratings that have lost value over the last year (TTM)

ratings_accuracy.1y_average_returnstring (double)

The average percent price difference per rating over the last year (TTM)

ratings_accuracy.1y_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last year (TTM)

ratings_accuracy.2y_gain_countstring (double)

The number of ratings that have gained value over the last two years

ratings_accuracy.2y_loss_countstring (double)

The number of ratings that have lost value over the last two years

ratings_accuracy.2y_average_returnstring (double)

The average percent price difference per rating over the last two years

ratings_accuracy.2y_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last two years

ratings_accuracy.3y_gain_countstring (double)

The number of ratings that have gained value over the last three years

ratings_accuracy.3y_loss_countstring (double)

The number of ratings that have lost value over the last three years

ratings_accuracy.3y_average_returnstring (double)

The average percent price difference per rating over the last three years

ratings_accuracy.3y_stdevstring (double)

The standard deviation in percent price difference in the analyst’s ratings over the last three years

ratings_accuracy.updatedinteger (int64)

Last update timstamp in UTC Unix epoch timestamp (seconds)

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

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

notesstring

Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML.

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",
  "currency": "string",
  "action_pt": "string",
  "action_company": "string",
  "rating_current": "string",
  "pt_current": "string (float)",
  "rating_prior": "string",
  "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)"
}

retail: object

PropertyTypeDescription
idstring

Unique ID of this entry

datestring (YYYY-MM-DD)

Date for sales announcement

timestring (HH:MM:SS)

Time for sales announcement

tickerstring

Ticker symbol of security

exchangestring

Name of exchange where security is listed

namestring

Name of security

currencystring

Currency the data is denominated in

periodstring , x ∈ { Q1 , Q2 , Q3 , Q4 , FY , Jan , Feb , Mar , Apr , May , Jun , Jul , Aug , Sep , Oct , Nov , Dec }

Period of the retail sales

period_yearinteger (YYYY)

Year for the period of the retail sales

sssstring (float)

Same-Store Sales

sss_eststring (float)

Same-Store Sales estimate

retail_surprisestring

Deviation from estimate

importanceinteger , x ∈ { 0 , 1 , 2 , 3 , 4 , 5 }

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

notesstring

Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML.

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",
  "currency": "string",
  "period": "string",
  "period_year": "integer (YYYY)",
  "sss": "string (float)",
  "sss_est": "string (float)",
  "retail_surprise": "string",
  "importance": "integer",
  "notes": "string",
  "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

webcast_urlstring (URL)

URL of webcast for conference call if avaliable

importanceinteger , x ∈ { 0 , 1 , 2 , 3 , 4 , 5 }

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

notesstring

Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML.

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",
  "webcast_url": "string (URL)",
  "importance": "integer",
  "notes": "string",
  "updated": "integer (int64)"
}

calendar-removed: object

PropertyTypeDescription
idstring

id of removed calendar content

typestring , x ∈ { ratings , earnings , guidance , ipo , offerings , economics , ma , retail , splits , dividends , conference calls }

Calendar type of removed content

updatedinteger (int64)

UTC Unix epoch timestamp (seconds)

Structure (JSON)
{
  "id": "string",
  "type": "string",
  "updated": "integer (int64)"
}