Calendar API Reference
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.1Response 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
| Name | Type | Location | Description |
|---|---|---|---|
accept | string , x ∈ { application/json (default) } | header | Specifies return format. Query parameters work the same for both formats. |
page | integer | query | 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 | query | 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
| Code | Model | Description |
|---|---|---|
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
| Name | Type | Location | Description |
|---|---|---|---|
accept | string , x ∈ { application/json (default) } | header | Specifies return format. Query parameters work the same for both formats. |
page | integer | query | 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 | query | 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
| Code | Model | Description |
|---|---|---|
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
| Name | Type | Location | Description |
|---|---|---|---|
accept | string , x ∈ { application/json (default) } | header | Specifies return format. Query parameters work the same for both formats. |
page | integer | query | 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 | query | 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 |
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
| Code | Model | Description |
|---|---|---|
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
| Name | Type | Location | Description |
|---|---|---|---|
accept | string , x ∈ { application/json (default) } | header | Specifies return format. Query parameters work the same for both formats. |
page | integer | query | 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 | query | 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. |
country | string (A-Z:3) | query | 3-Digit Country Code |
Responses
| Code | Model | Description |
|---|---|---|
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
| Name | Type | Location | Description |
|---|---|---|---|
accept | string , x ∈ { application/json (default) } | header | Specifies return format. Query parameters work the same for both formats. |
page | integer | query | 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 | query | 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 |
parameters[date_search_strict] | boolean | query | 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 |
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
| Code | Model | Description |
|---|---|---|
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
| Name | Type | Location | Description |
|---|---|---|---|
accept | string , x ∈ { application/json (default) } | header | Specifies return format. Query parameters work the same for both formats. |
page | integer | query | 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 | query | 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
| Code | Model | Description |
|---|---|---|
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
| Name | Type | Location | Description |
|---|---|---|---|
accept | string , x ∈ { application/json (default) } | header | Specifies return format. Query parameters work the same for both formats. |
page | integer | query | 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 | query | 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
| Code | Model | Description |
|---|---|---|
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
| Name | Type | Location | Description |
|---|---|---|---|
accept | string , x ∈ { application/json (default) } | header | Specifies return format. Query parameters work the same for both formats. |
page | integer | query | 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 | query | 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
| Code | Model | Description |
|---|---|---|
200 OK | offerings | 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
| Name | Type | Location | Description |
|---|---|---|---|
accept | string , x ∈ { application/json (default) } | header | Specifies return format. Query parameters work the same for both formats. |
fields | string (csv) | query | Available fields:
Default fields:
|
page | integer | query | 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 | query | 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. |
analyst | string (csv) | query | A comma separated list of analyst (person) ID's to bring back. Omitting will bring back all available analysts. |
firm | string (csv) | query | A comma separated list of analyst firm ID's to bring back. Omitting will bring back all available firms. |
Responses
| Code | Model | Description |
|---|---|---|
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
| Name | Type | Location | Description |
|---|---|---|---|
accept | string , x ∈ { application/json (default) } | header | Specifies return format. Query parameters work the same for both formats. |
page | integer | query | 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 | query | 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
| Code | Model | Description |
|---|---|---|
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
| Name | Type | Location | Description |
|---|---|---|---|
accept | string , x ∈ { application/json (default) } | header | Specifies return format. Query parameters work the same for both formats. |
page | integer | query | 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 | query | 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
| Code | Model | Description |
|---|---|---|
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
| Name | Type | Location | Description |
|---|---|---|---|
accept | string , x ∈ { application/json (default) } | header | Specifies return format. Query parameters work the same for both formats. |
page | integer | query | 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 | query | 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 |
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
| Code | Model | Description |
|---|---|---|
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
| Name | Type | Location | Description |
|---|---|---|---|
accept | string , x ∈ { application/json (default) } | header | Specifies return format. Query parameters work the same for both formats. |
page | integer | query | 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 | query | Number of results returned. Limit 1000. Default 50. |
type | string , x ∈ { ratings , earnings , guidance , ipos , offerings , economics , ma , retail , splits , dividends , conference calls } | query | Calendar type |
updated | integer (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
| Code | Model | Description |
|---|---|---|
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
| Name | Type | Location | Description |
|---|---|---|---|
fields | string (csv) | query | Available fields:
Default fields:
|
analyst | string (csv) | query | A comma separated list of analyst (person) ID's to bring back. Omitting will bring back all available analysts. |
page | integer | query | 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 | query | Number of results returned. Limit 1000. Default 50. |
updated | integer (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
| Code | Model | Description |
|---|---|---|
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
| Name | Type | Location | Description |
|---|---|---|---|
fields | string (csv) | query | Available fields:
Default fields:
|
firm | string (csv) | query | A comma separated list of analyst firm ID's to bring back. Omitting will bring back all available firms. |
page | integer | query | 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 | query | Number of results returned. Limit 1000. Default 50. |
updated | integer (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
| Code | Model | Description |
|---|---|---|
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
| Property | Type | Description |
|---|---|---|
id | string | Id of the analyst |
firm_id | string | Id of the analyst firm |
firm_name | string | Firm name of the analyst |
name_first | string | Analyst first name |
name_last | string | Analyst last name |
name_full | string | Analyst full name for display |
ratings_accuracy | object | Analyst accuracy scores |
ratings_accuracy.smart_score | string (double) | A weighted average of the total_ratings_percentile, overall_avg_return_percentile, and overall_success_rate |
ratings_accuracy.overall_success_rate | string (double) | The percentage of gain/loss ratings that resulted in a gain overall |
ratings_accuracy.overall_avg_return_percentile | string (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_percentile | string (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_ratings | integer (int64) | Number of recommendations made by this analyst |
ratings_accuracy.overall_gain_count | integer (int64) | The number of ratings that have gained value since the date of recommendation |
ratings_accuracy.overall_loss_count | integer (int64) | The number of ratings that have lost value since the date of recommendation |
ratings_accuracy.overall_average_return | string (double) | The average percent price difference per rating since the date of recommendation |
ratings_accuracy.overall_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings since the date of recommendation |
ratings_accuracy.1m_gain_count | string (double) | The number of ratings that have gained value over the last month |
ratings_accuracy.1m_loss_count | string (double) | The number of ratings that have lost value over the last month |
ratings_accuracy.1m_average_return | string (double) | The average percent price difference per rating over the last month |
ratings_accuracy.1m_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last month |
ratings_accuracy.3m_gain_count | string (double) | The number of ratings that have gained value over the last three months |
ratings_accuracy.3m_loss_count | string (double) | The number of ratings that have lost value over the last three months |
ratings_accuracy.3m_average_return | string (double) | The average percent price difference per rating over the last three months |
ratings_accuracy.3m_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last three months |
ratings_accuracy.9m_gain_count | string (double) | The number of ratings that have gained value over the last nine months |
ratings_accuracy.9m_loss_count | string (double) | The number of ratings that have lost value over the last nine months |
ratings_accuracy.9m_average_return | string (double) | The average percent price difference per rating over the last nine months |
ratings_accuracy.9m_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last nine months |
ratings_accuracy.1y_gain_count | string (double) | The number of ratings that have gained value over the last year (TTM) |
ratings_accuracy.1y_loss_count | string (double) | The number of ratings that have lost value over the last year (TTM) |
ratings_accuracy.1y_average_return | string (double) | The average percent price difference per rating over the last year (TTM) |
ratings_accuracy.1y_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last year (TTM) |
ratings_accuracy.2y_gain_count | string (double) | The number of ratings that have gained value over the last two years |
ratings_accuracy.2y_loss_count | string (double) | The number of ratings that have lost value over the last two years |
ratings_accuracy.2y_average_return | string (double) | The average percent price difference per rating over the last two years |
ratings_accuracy.2y_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last two years |
ratings_accuracy.3y_gain_count | string (double) | The number of ratings that have gained value over the last three years |
ratings_accuracy.3y_loss_count | string (double) | The number of ratings that have lost value over the last three years |
ratings_accuracy.3y_average_return | string (double) | The average percent price difference per rating over the last three years |
ratings_accuracy.3y_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last three years |
ratings_accuracy.updated | integer (int64) | Last update timstamp in UTC Unix epoch timestamp (seconds) |
updated | integer (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
| Property | Type | Description |
|---|---|---|
smart_score | string (double) | A weighted average of the total_ratings_percentile, overall_avg_return_percentile, and overall_success_rate |
overall_success_rate | string (double) | The percentage of gain/loss ratings that resulted in a gain overall |
overall_avg_return_percentile | string (double) | The percentile of this analyst’s overall average return per rating in comparison to other analysts' overall average returns per rating |
total_ratings_percentile | string (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_ratings | integer (int64) | Number of recommendations made by this analyst |
overall_gain_count | integer (int64) | The number of ratings that have gained value since the date of recommendation |
overall_loss_count | integer (int64) | The number of ratings that have lost value since the date of recommendation |
overall_average_return | string (double) | The average percent price difference per rating since the date of recommendation |
overall_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings since the date of recommendation |
1m_gain_count | string (double) | The number of ratings that have gained value over the last month |
1m_loss_count | string (double) | The number of ratings that have lost value over the last month |
1m_average_return | string (double) | The average percent price difference per rating over the last month |
1m_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last month |
3m_gain_count | string (double) | The number of ratings that have gained value over the last three months |
3m_loss_count | string (double) | The number of ratings that have lost value over the last three months |
3m_average_return | string (double) | The average percent price difference per rating over the last three months |
3m_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last three months |
9m_gain_count | string (double) | The number of ratings that have gained value over the last nine months |
9m_loss_count | string (double) | The number of ratings that have lost value over the last nine months |
9m_average_return | string (double) | The average percent price difference per rating over the last nine months |
9m_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last nine months |
1y_gain_count | string (double) | The number of ratings that have gained value over the last year (TTM) |
1y_loss_count | string (double) | The number of ratings that have lost value over the last year (TTM) |
1y_average_return | string (double) | The average percent price difference per rating over the last year (TTM) |
1y_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last year (TTM) |
2y_gain_count | string (double) | The number of ratings that have gained value over the last two years |
2y_loss_count | string (double) | The number of ratings that have lost value over the last two years |
2y_average_return | string (double) | The average percent price difference per rating over the last two years |
2y_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last two years |
3y_gain_count | string (double) | The number of ratings that have gained value over the last three years |
3y_loss_count | string (double) | The number of ratings that have lost value over the last three years |
3y_average_return | string (double) | The average percent price difference per rating over the last three years |
3y_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last three years |
updated | integer (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
| Property | Type | Description |
|---|---|---|
id | string | Id of the analyst firm |
currency | string | Default currency of the analyst firm |
homepage | string | URL for the analyst firm |
name | string | Analyst firm name |
updated | integer (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
| Property | Type | Description |
|---|---|---|
id | string | Unique ID of this entry |
date | string (YYYY-DD-MM) | Announced Date on calendar |
notes | string | Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML. |
updated | integer | Last updated timestamp, UTC |
ticker | string | Ticker Symbol (F, MSFT, etc...) |
name | string | Name of security |
exchange | string | Exchange (NYSE, NASDAQ, etc...) |
currency | string | Currency the data is denominated in |
frequency | integer | Frequency of the dividend |
dividend | string (double) | Dividend value. Expected value is a double if set or empty if null. |
dividend_prior | string (double) | Period prior dividend value. Expected value is a double if set or empty if null. |
dividend_type | string | Type of dividend |
dividend_yield | string (double) | Yield of dividend. Expected value is a double if set or empty if null. |
ex_dividend_date | string (YYYY-DD-MM) | Dividend Ex Date |
payable_date | string (YYYY-DD-MM) | Dividend Payable Date |
record_date | string (YYYY-DD-MM) | Dividend Recorded Date |
importance | integer , 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
| Property | Type | Description |
|---|---|---|
id | string | - |
date | string (YYYY-DD-MM) | Announced Date on Calendar |
date_confirmed | string (1/0) | If the report date was confirmed (vs est) |
time | string (HH:MM:SS) | Announced Time on Calendar, 24hr format |
ticker | string | Ticker Symbol (F, MSFT, etc...) |
exchange | string | Exchange (NYSE, NASDAQ, etc...) |
name | string | Name of security |
currency | string | Currency the data is denominated in |
period | string , x ∈ { Q1 , Q2 , Q3 , Q4 , FY , H1 , H2 } | Period of the earnings actual |
period_year | integer | Period Year of the earnings actual |
eps_type | string , x ∈ { Adj , GAAP , FFO } | EPS Type |
eps | string (double) | Comparable and Adjusted Earnings Per Share |
eps_est | string (double) | Adjusted EPS Consensus Aggregate Analyst Estimate |
eps_prior | string (double) | Adjusted EPS from Prior Period |
eps_surprise | string (double) | EPS deviation from estimate |
eps_surprise_percent | string (double) | Deviation from estimate as percentage |
revenue_type | string , x ∈ { Adj , GAAP , FFO } | Revenue Type |
revenue | string (integer) | Revenue |
revenue_est | string (integer) | Revenue estimate |
revenue_prior | string (integer) | Revenue value for previous period |
revenue_surprise | string (integer) | Revenue deviation from estimate |
revenue_surprise_percent | string (double) | Deviation from estimate as percentage |
importance | integer , x ∈ { 0 , 1 , 2 , 3 , 4 , 5 } | Subjective basis of how important event is to market. 5 = high |
notes | string | Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML. |
updated | integer | 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
| Property | Type | Description |
|---|---|---|
id | string | Unique ID of this entry |
event_type | string , x ∈ { clinical_trial , approval_fda , approval_foreign , pdufa_date } | Specifies which type of event the row represents. |
date | string (YYYY-DD-MM) | Date on which Benzinga received the information |
time | string (HH:MM:SS) | Time at which Benzinga received the information |
companies | object[] | Companies developing the drug |
companies[].id | string | Company ID |
companies[].name | string | Company name |
companies[].cik | string (10-digit integer) | Company primary CIK |
companies[].securities | object[] | Company securities |
companies[].securities[].exchange | string | Exchange on which the security is listed |
companies[].securities[].symbol | string | Ticker symbol for the security |
drug | object | - |
drug.id | integer | Internal ID for the drug |
drug.name | string | Name of the drug |
drug.indication_symptom | string[] | Indications/symptoms |
drug.generic | boolean | Is this a generic drug? |
status | string | The announced status of the drug |
nic_number | string (NCTXXXXXXXX) | The US National Library of Medicine's individual identifier for each clinical trial |
target_date | string (YYYY-MM-DD, YYYY-MM, YYYY-Q[1-4], YYYY-H[1-2], or YYYY-[EARLY, MID, LATE]) | The announced target date |
outcome_brief | string , 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 |
outcome | string | The significance/outcome of the announcement |
commentary | string | Additional information beyond the few-sentence outcome |
source_type | string , x ∈ { Press Release , FDA Website , Other } | The type of source from which this data was obtained |
source_link | string | The URL of the source |
notes | string | Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML. |
created | integer | Object creation Unix timestamp, UTC |
updated | integer | 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
| Property | Type | Description |
|---|---|---|
id | string | Unique ID of this entry |
updated | integer | Last updated timestamp, UTC |
date_announced | string (YYYY-DD-MM) | Announced Date on calendar (formerly labeled as date in our docs). |
ticker | string | Ticker Symbol (F, MSFT, etc...) |
exchange | string | Exchange (NYSE, NASDAQ, etc...) |
ratio | string (x:y) | Ratio of the split |
optionable | boolean | Is the script optionable? |
date_ex | string (YYYY-MM-DD) | Ex date |
date_recorded | string (YYYY-MM-DD) | Recorded date |
date_distribution | string (YYYY-MM-DD) | Distribution date |
importance | integer , x ∈ { 0 , 1 , 2 , 3 , 4 , 5 } | Subjective basis of how important event is to market. 5 = high |
notes | string | 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
| Property | Type | Description |
|---|---|---|
id | string | Unique identifier for each data point |
date | string (YYYY-MM-DD) | - |
time | string (HH:MM:SS) | Announced Time on Calendar, 24hr format |
country | string | 3-Character Country Code (USA, CAN, etc...) |
event_name | string | Economic Event |
event_period | string | Period of Time (Q1, September, Third Week of August,...) |
period_year | integer (YYYY) | Period Year |
actual | string (float) | Value of economic indicator |
actual_t | string | Unit for actual field |
consensus | string (float) | Estimate for actual field |
consensus_t | string | Unit for consensus field |
prior | string (float) | Value of actual field for previous period |
prior_t | string | Unit for prior field |
importance | integer , x ∈ { 0 , 1 , 2 , 3 , 4 , 5 } | Subjective basis of how important event is to market. 5 = High |
updated | integer | Last updated timestamp, UTC |
description | string | 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
| Property | Type | Description |
|---|---|---|
id | string | Unique ID of this entry |
date | string (YYYY-MM-DD) | Announced Date on Calendar |
time | string (HH:MM:SS) | Announced Time on Calendar, 24hr format |
ticker | string | Ticker symbol of company guidance data is for |
exchange | string | Exchange (NYSE, NASDAQ, etc...) |
name | string | The name of the publicly traded company that the guidance data is for |
currency | string | Currency the data is denominated in |
period | string , x ∈ { Q1 , Q2 , Q3 , Q4 , FY } | Period within-year of the guidance |
period_year | integer (YYYY) | Period year of the guidance |
prelim | string , x ∈ { Y , N } | Yes or No for if guidance is a preliminary earnings report |
is_primary | string , x ∈ { Y , N , All } | Specifies type of guidance returned - primary, secondary or all |
eps_type | string , x ∈ { Adj , GAAP , FFO } | Reported EPS Type can be Adjusted, GAAP or FFO. FFO is only used for REITs. |
eps_guidance_est | string (float) | Adjusted EPS Consensus Estimate |
eps_guidance_max | string (float) | Adjusted EPS from Prior Period Max |
eps_guidance_min | string (float) | Adjusted EPS from Prior Period Min |
eps_guidance_prior_max | string (float) | Adjusted EPS from Prior Period Max |
eps_guidance_prior_min | string (float) | Adjusted EPS from Prior Period Min |
revenue_guidance_est | string (float) | Revenue guidance estimate |
revenue_guidance_max | string (float) | Revenue guidance max |
revenue_guidance_min | string (float) | Revenue guidance min |
revenue_guidance_prior_max | string (float) | Revenue guidance max from previous period |
revenue_guidance_prior_min | string (float) | Revenue guidance min from previous period |
revenue_type | string , x ∈ { Adj , GAAP , FFO } | Revenue Type |
importance | integer , x ∈ { 0 , 1 , 2 , 3 , 4 , 5 } | Subjective basis of how important event is to market. 5 = high |
notes | string | Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML. |
updated | integer (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
| Property | Type | Description |
|---|---|---|
id | string | Unique ID of this entry |
date | string (YYYY-MM-DD, YYYY-QN, YYYY-MM, YYYY-HN, YYYY) | Expected (Actual) IPO Open Date |
time | string (HH:MM:SS) | Time of row entry |
ticker | string | Ticker symbol for IPO |
exchange | string | Exchange (NYSE, NASDAQ, etc...) |
name | string | The name of the IPO company |
open_date_verified | boolean | Is the IPO open date verified? |
pricing_date | string (YYYY-MM-DD) | date of IPO pricing |
currency | string | Currency the data is denominated in |
price_min | string (double) | Minimum open price |
price_max | string (double) | Maximum open price |
price_public_offering | string (double) | Price at which the company sells its shares to investors during an IPO |
price_open | string (double) | Price at open |
deal_status | string , x ∈ { Rumored , Initial Filing , Amended , Priced , Closed , Postponed , Withdrawn } | status of IPO |
ipo_type | string , x ∈ { Ordinary Shares , Depository Receipt , Unit , SPAC Unit , SPAC , MandA , Direct Listing , } | Type of IPO |
insider_lockup_days | integer | Insider lockup period in days |
insider_lockup_date | string (YYYY-MM-DD) | Insider lockup date |
offering_value | integer (int64) | Value of IPO (offering_shares multiplied by the public offering price) |
offering_shares | integer (int64) | Number of shares offered in IPO |
shares_outstanding | integer | Temporarily unavailable. If pre-IPO shares outstanding is an important data field for you, please let us know. |
lead_underwriters | string[] | List of lead underwriter(s) |
other_underwriters | string[] | List of other/secondary underwriter(s) |
underwriter_quiet_expiration_days | integer | Underwriter quite expiration period in days |
underwriter_quiet_expiration_date | string (YYYY-MM-DD) | Underwriter quite expiration date |
notes | string | Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML. |
updated | integer (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
| Property | Type | Description |
|---|---|---|
id | string | Unique ID of this entry |
date | string (YYYY-MM-DD, YYYY-QN, YYYY-MM, YYYY-HN, YYYY) | Date of offering issuance |
time | string (HH:MM:SS) | Time of offering issuance |
ticker | string | Ticker symbol for offering |
exchange | string | Exchange (NYSE, NASDAQ, etc...) |
name | string | The name of the company |
currency | string | The currency of the offering |
shelf | boolean | 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. |
price | string (double) | The offering price |
proceeds | string (double) | The total value of the offering |
number_shares | integer | The number of shares in the offering |
importance | integer | Benzinga assigned score for how important the event is |
notes | string | Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML. |
updated | integer (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
| Property | Type | Description |
|---|---|---|
id | string | Undque ID of this entry |
date | string (YYYY-MM-DD) | Date of deal announcment |
date_expected | string (YYYY-MM-DD, YYYY-QN, YYYY-MM) | Date deal is expected to complete |
date_completed | string (YYYY-MM-DD) | Date of deal completion |
acquirer_ticker | string | Ticker symbol of acquiring company |
acquirer_exchange | string | Exchange for the acquirer ticker |
acquirer_name | string | Name of acquiring company |
target_ticker | string | Ticker symbol of target company |
target_exchange | string | Exchange for the target ticker |
target_name | string | Name of the target company |
currency | string | Currency the data is denominated in |
deal_type | string , x ∈ { Acquisition , Merger , Asset Sale } | Type of deal |
deal_size | string (double) | Aggregate deal value |
deal_payment_type | string , x ∈ { Cash , Stock , Cash & Stock } | Deal payment type |
deal_status | string , x ∈ { Rumored , Announced , Regulatory Review , Completed , Canceled } | Deal status |
deal_terms_extra | string | Any additional relevant terms |
importance | integer | Benzinga assigned score for how important entry is |
notes | string | Any supplimentarty details. Used in conjunction with Deal Terms for non term notes |
updated | integer (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
| Property | Type | Description |
|---|---|---|
id | string | Unique ID of this entry |
date | string (YYYY-MM-DD) | Date for rating |
time | string (HH:MM:SS) | Time for rating |
ticker | string | Ticker symbol of company that is subject of rating |
exchange | string | Exchange (NYSE, NASDAQ, etc...) |
name | string | Name of company that is subject of rating |
currency | string | Currency the data is denominated in |
action_pt | string , x ∈ { Announces , Maintains , Lowers , Raises , Removes } | Description of the change in price target from firm's last price target |
action_company | string , 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_current | string | The analyst's rating for the company |
pt_current | string (float) | Analyst's current price target |
rating_prior | string | Prior analyst rating for the company |
pt_prior | string (float) | Analyst's prior price target |
url | string (URL) | URL for analyst ratings page for this ticker on Benzinga.com |
url_calendar | string (URL) | URL for analyst ratings page for this ticker on Benzinga.com |
url_news | string (URL) | URL for analyst ratings news articles for this ticker on Benzinga.com |
analyst | string | Name of the analyst firm that published the rating |
analyst_id | string | Id of the analyst |
analyst_name | string | Name of the analyst (person) that published the rating |
ratings_accuracy | object | Analyst accuracy scores |
ratings_accuracy.smart_score | string (double) | A weighted average of the total_ratings_percentile, overall_avg_return_percentile, and overall_success_rate |
ratings_accuracy.overall_success_rate | string (double) | The percentage of gain/loss ratings that resulted in a gain overall |
ratings_accuracy.overall_avg_return_percentile | string (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_percentile | string (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_ratings | integer (int64) | Number of recommendations made by this analyst |
ratings_accuracy.overall_gain_count | integer (int64) | The number of ratings that have gained value since the date of recommendation |
ratings_accuracy.overall_loss_count | integer (int64) | The number of ratings that have lost value since the date of recommendation |
ratings_accuracy.overall_average_return | string (double) | The average percent price difference per rating since the date of recommendation |
ratings_accuracy.overall_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings since the date of recommendation |
ratings_accuracy.1m_gain_count | string (double) | The number of ratings that have gained value over the last month |
ratings_accuracy.1m_loss_count | string (double) | The number of ratings that have lost value over the last month |
ratings_accuracy.1m_average_return | string (double) | The average percent price difference per rating over the last month |
ratings_accuracy.1m_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last month |
ratings_accuracy.3m_gain_count | string (double) | The number of ratings that have gained value over the last three months |
ratings_accuracy.3m_loss_count | string (double) | The number of ratings that have lost value over the last three months |
ratings_accuracy.3m_average_return | string (double) | The average percent price difference per rating over the last three months |
ratings_accuracy.3m_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last three months |
ratings_accuracy.9m_gain_count | string (double) | The number of ratings that have gained value over the last nine months |
ratings_accuracy.9m_loss_count | string (double) | The number of ratings that have lost value over the last nine months |
ratings_accuracy.9m_average_return | string (double) | The average percent price difference per rating over the last nine months |
ratings_accuracy.9m_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last nine months |
ratings_accuracy.1y_gain_count | string (double) | The number of ratings that have gained value over the last year (TTM) |
ratings_accuracy.1y_loss_count | string (double) | The number of ratings that have lost value over the last year (TTM) |
ratings_accuracy.1y_average_return | string (double) | The average percent price difference per rating over the last year (TTM) |
ratings_accuracy.1y_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last year (TTM) |
ratings_accuracy.2y_gain_count | string (double) | The number of ratings that have gained value over the last two years |
ratings_accuracy.2y_loss_count | string (double) | The number of ratings that have lost value over the last two years |
ratings_accuracy.2y_average_return | string (double) | The average percent price difference per rating over the last two years |
ratings_accuracy.2y_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last two years |
ratings_accuracy.3y_gain_count | string (double) | The number of ratings that have gained value over the last three years |
ratings_accuracy.3y_loss_count | string (double) | The number of ratings that have lost value over the last three years |
ratings_accuracy.3y_average_return | string (double) | The average percent price difference per rating over the last three years |
ratings_accuracy.3y_stdev | string (double) | The standard deviation in percent price difference in the analyst’s ratings over the last three years |
ratings_accuracy.updated | integer (int64) | Last update timstamp in UTC Unix epoch timestamp (seconds) |
importance | string , x ∈ { 0 , 1 , 2 , 3 , 4 , 5 } | Subjective Basis of How Important Event is to Market. 5 = High |
notes | string | Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML. |
updated | integer (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
| Property | Type | Description |
|---|---|---|
id | string | Unique ID of this entry |
date | string (YYYY-MM-DD) | Date for sales announcement |
time | string (HH:MM:SS) | Time for sales announcement |
ticker | string | Ticker symbol of security |
exchange | string | Name of exchange where security is listed |
name | string | Name of security |
currency | string | Currency the data is denominated in |
period | string , x ∈ { Q1 , Q2 , Q3 , Q4 , FY , Jan , Feb , Mar , Apr , May , Jun , Jul , Aug , Sep , Oct , Nov , Dec } | Period of the retail sales |
period_year | integer (YYYY) | Year for the period of the retail sales |
sss | string (float) | Same-Store Sales |
sss_est | string (float) | Same-Store Sales estimate |
retail_surprise | string | Deviation from estimate |
importance | integer , x ∈ { 0 , 1 , 2 , 3 , 4 , 5 } | Subjective Basis of How Important Event is to Market. 5 = High |
notes | string | Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML. |
updated | integer (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
| Property | Type | Description |
|---|---|---|
id | string | Unique ID of this entry |
date | string (YYYY-MM-DD) | Announced Date on Calendar |
time | string (HH:MM:SS) | Announced Time on Calendar |
name | string | Name of company |
exchange | string | Exchange (NYSE, NASDAQ, etc...) |
ticker | string | Ticker symbol of company |
start_time | string (HH:MM:SS) | Time of earnings conference call, in local time |
phone_num | string (NNN-NNN-NNNN) | Phone number of conference call |
international_num | string (NNN-NNN-NNNN) | International number to call if outside USA |
reservation_num | string (NNN-NNN-NNNN) | Reservation number for conference call if avaliable |
access_code | string | Access code for conference call if available |
webcast_url | string (URL) | URL of webcast for conference call if avaliable |
importance | integer , x ∈ { 0 , 1 , 2 , 3 , 4 , 5 } | Subjective Basis of How Important Event is to Market. 5 = High |
notes | string | Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML. |
updated | integer (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
| Property | Type | Description |
|---|---|---|
id | string | id of removed calendar content |
type | string , x ∈ { ratings , earnings , guidance , ipo , offerings , economics , ma , retail , splits , dividends , conference calls } | Calendar type of removed content |
updated | integer (int64) | UTC Unix epoch timestamp (seconds) |
Structure (JSON)
{
"id": "string",
"type": "string",
"updated": "integer (int64)"
}