> ## Documentation Index > Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt > Use this file to discover all available pages before exploring further. # benzinga-calendar > Benzinga Calendar **Server path:** `/benzinga-calendar` | **Type:** Application | **PCID required:** Yes ## Tools | Tool | Description | | ------------------------------------------------------------------------------------- | ------------------------------------------------------------- | | [`benzinga_calendar_get_conference_calls`](#benzinga_calendar_get_conference_calls) | Returns Conference call data | | [`benzinga_calendar_get_consensus_ratings`](#benzinga_calendar_get_consensus_ratings) | Returns analyst ratings data] | | [`benzinga_calendar_get_dividends`](#benzinga_calendar_get_dividends) | Dividends Events | | [`benzinga_calendar_get_dividends_1`](#benzinga_calendar_get_dividends_1) | Dividends Events | | [`benzinga_calendar_get_earnings`](#benzinga_calendar_get_earnings) | Returns the earnings data | | [`benzinga_calendar_get_economics`](#benzinga_calendar_get_economics) | Returns the economic calendar data | | [`benzinga_calendar_get_fda`](#benzinga_calendar_get_fda) | FDA approvals, clinical trials, and PDUFA dates | | [`benzinga_calendar_get_guidance`](#benzinga_calendar_get_guidance) | Returns guidance data | | [`benzinga_calendar_get_ipos`](#benzinga_calendar_get_ipos) | Returns ipo data | | [`benzinga_calendar_get_ma`](#benzinga_calendar_get_ma) | Returns the mergers and acquisitions data | | [`benzinga_calendar_get_offerings`](#benzinga_calendar_get_offerings) | Returns Secondary Offering data | | [`benzinga_calendar_get_ratings`](#benzinga_calendar_get_ratings) | Returns analyst ratings data | | [`benzinga_calendar_get_ratings_analysts`](#benzinga_calendar_get_ratings_analysts) | Returns the full list of analysts that are providing ratings. | | [`benzinga_calendar_get_ratings_firms`](#benzinga_calendar_get_ratings_firms) | Returns the available firms providing analyst ratings | | [`benzinga_calendar_get_removed`](#benzinga_calendar_get_removed) | Returns the removed calendar data | | [`benzinga_calendar_get_splits`](#benzinga_calendar_get_splits) | Returns the splits calendar data | *** ## benzinga\_calendar\_get\_conference\_calls Returns Conference call data **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `page` | integer | No | — | 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 | No | — | Number of results returned. Limit 1000 | | `parameters[date]` | string | No | — | 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 | No | — | Date to query from point in time. | | `parameters[date_to]` | string | No | — | Date to query to point in time. | | `parameters[tickers]` | string | No | — | 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 | No | — | Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "page": { "type": "integer", "description": "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": { "type": "integer", "description": "Number of results returned. Limit 1000" }, "parameters[date]": { "type": "string", "description": "Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest." }, "parameters[date_from]": { "type": "string", "description": "Date to query from point in time." }, "parameters[date_to]": { "type": "string", "description": "Date to query to point in time." }, "parameters[tickers]": { "type": "string", "description": "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]": { "type": "integer", "description": "Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated." } }, "required": [ "PCID" ] } ``` *** ## benzinga\_calendar\_get\_consensus\_ratings Returns analyst ratings data] **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------------- | ------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `pagesize` | integer | No | — | Number of results returned. Limit 1000 | | `parameters[date_from]` | string | No | — | Date to query from point in time. | | `parameters[date_to]` | string | No | — | Date to query to point in time. | | `parameters[tickers]` | string | No | — | One ticker symbol to query the aggregate for. All calendars accept this parameter (not including the FDA endpoint; for the FDA endpoint, please use "parameters\[securities]" instead). Ignored by the Economics endpoint. Maximum 1 ticker. | | `simplify` | boolean | No | — | To simplify the aggregate ratings to only BUY, SELL, HOLD, default will return all ratings (STRONG\_BUY, BUY, HOLD, SELL, STRONG\_SELL). | | `aggregate_type` | string | No | — | To aggregate the ratings by either number or percentage. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "pagesize": { "type": "integer", "description": "Number of results returned. Limit 1000" }, "parameters[date_from]": { "type": "string", "description": "Date to query from point in time." }, "parameters[date_to]": { "type": "string", "description": "Date to query to point in time." }, "parameters[tickers]": { "type": "string", "description": "One ticker symbol to query the aggregate for. All calendars accept this parameter (not including the FDA endpoint; for the FDA endpoint, please use \"parameters[securities]\" instead). Ignored by the Economics endpoint. Maximum 1 ticker." }, "simplify": { "type": "boolean", "description": "To simplify the aggregate ratings to only BUY, SELL, HOLD, default will return all ratings (STRONG_BUY, BUY, HOLD, SELL, STRONG_SELL)." }, "aggregate_type": { "type": "string", "description": "To aggregate the ratings by either number or percentage.", "enum": [ "number", "percentage" ] } }, "required": [ "PCID" ] } ``` *** ## benzinga\_calendar\_get\_dividends Dividends Events **Parameters:** | Parameter | Type | Required | Default | Description | | -------------------------------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `page` | integer | No | — | 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 | No | — | Number of results returned. Limit 1000 | | `parameters[date]` | string | No | — | 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 | No | — | Date to query from point in time. | | `parameters[date_to]` | string | No | — | Date to query to point in time. | | `parameters[tickers]` | string | No | — | 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 | No | — | The importance level to filter by. Uses Greater Than or Equal To the importance indicated | | `parameters[date_sort]` | string | No | — | Dividend date field to sort on (newest to oldest) | | `parameters[updated]` | integer | No | — | 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 | No | — | 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 | No | — | 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. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "page": { "type": "integer", "description": "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": { "type": "integer", "description": "Number of results returned. Limit 1000" }, "parameters[date]": { "type": "string", "description": "Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest." }, "parameters[date_from]": { "type": "string", "description": "Date to query from point in time." }, "parameters[date_to]": { "type": "string", "description": "Date to query to point in time." }, "parameters[tickers]": { "type": "string", "description": "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]": { "type": "integer", "description": "The importance level to filter by. Uses Greater Than or Equal To the importance indicated", "enum": [ 0, 1, 2, 3, 4, 5 ] }, "parameters[date_sort]": { "type": "string", "description": "Dividend date field to sort on (newest to oldest)", "enum": [ "announced", "ex", "payable", "record" ] }, "parameters[updated]": { "type": "integer", "description": "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]": { "type": "string", "description": "Specifies how to filter using dividend yield. gt = Greater Than, gte = Greater Than Equal, eq = Equal, lt = Less Than, lte = Less Than Equal", "enum": [ "gt", "gte", "eq", "lte", "lt" ] }, "parameters[dividend_yield]": { "type": "number", "description": "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." } }, "required": [ "PCID" ] } ``` *** ## benzinga\_calendar\_get\_dividends\_1 Dividends Events **Parameters:** | Parameter | Type | Required | Default | Description | | -------------------------------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `page` | integer | No | — | 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 | No | — | Number of results returned. Limit 1000 | | `parameters[date]` | string | No | — | 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 | No | — | Date to query from point in time. | | `parameters[date_to]` | string | No | — | Date to query to point in time. | | `parameters[tickers]` | string | No | — | 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 | No | — | The importance level to filter by. Uses Greater Than or Equal To the importance indicated | | `parameters[date_sort]` | string | No | — | Dividend date field to sort on (newest to oldest) | | `parameters[updated]` | integer | No | — | 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 | No | — | 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 | No | — | 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. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "page": { "type": "integer", "description": "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": { "type": "integer", "description": "Number of results returned. Limit 1000" }, "parameters[date]": { "type": "string", "description": "Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest." }, "parameters[date_from]": { "type": "string", "description": "Date to query from point in time." }, "parameters[date_to]": { "type": "string", "description": "Date to query to point in time." }, "parameters[tickers]": { "type": "string", "description": "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]": { "type": "integer", "description": "The importance level to filter by. Uses Greater Than or Equal To the importance indicated", "enum": [ 0, 1, 2, 3, 4, 5 ] }, "parameters[date_sort]": { "type": "string", "description": "Dividend date field to sort on (newest to oldest)", "enum": [ "announced", "ex", "payable", "record" ] }, "parameters[updated]": { "type": "integer", "description": "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]": { "type": "string", "description": "Specifies how to filter using dividend yield. gt = Greater Than, gte = Greater Than Equal, eq = Equal, lt = Less Than, lte = Less Than Equal", "enum": [ "gt", "gte", "eq", "lte", "lt" ] }, "parameters[dividend_yield]": { "type": "number", "description": "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." } }, "required": [ "PCID" ] } ``` *** ## benzinga\_calendar\_get\_earnings Returns the earnings data **Parameters:** | Parameter | Type | Required | Default | Description | | ------------------------ | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `page` | integer | No | — | 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 | No | — | Number of results returned. Limit 1000 | | `parameters[date]` | string | No | — | 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 | No | — | Date to query from point in time. | | `parameters[date_to]` | string | No | — | Date to query to point in time. | | `parameters[date_sort]` | string | No | — | Field sort option for earnings calendar. Apply `:desc`, `:asc` for sort order. | | `parameters[tickers]` | string | No | — | 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 | No | — | The importance level to filter by. Uses Greater Than or Equal To the importance indicated | | `parameters[updated]` | integer | No | — | Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "page": { "type": "integer", "description": "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": { "type": "integer", "description": "Number of results returned. Limit 1000" }, "parameters[date]": { "type": "string", "description": "Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest." }, "parameters[date_from]": { "type": "string", "description": "Date to query from point in time." }, "parameters[date_to]": { "type": "string", "description": "Date to query to point in time." }, "parameters[date_sort]": { "type": "string", "description": "Field sort option for earnings calendar. Apply `:desc`, `:asc` for sort order.", "enum": [ "date" ] }, "parameters[tickers]": { "type": "string", "description": "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]": { "type": "integer", "description": "The importance level to filter by. Uses Greater Than or Equal To the importance indicated", "enum": [ 0, 1, 2, 3, 4, 5 ] }, "parameters[updated]": { "type": "integer", "description": "Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated." } }, "required": [ "PCID" ] } ``` *** ## benzinga\_calendar\_get\_economics Returns the economic calendar data **Parameters:** | Parameter | Type | Required | Default | Description | | ------------------------ | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `page` | integer | No | — | 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 | No | — | Number of results returned. Limit 1000 | | `parameters[date]` | string | No | — | 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 | No | — | Date to query from point in time. | | `parameters[date_to]` | string | No | — | Date to query to point in time. | | `parameters[importance]` | integer | No | — | The importance level to filter by. Uses Greater Than or Equal To the importance indicated | | `parameters[updated]` | integer | No | — | Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated. | | `country` | string | No | — | 3-Digit Country Code | | `event_category` | string | No | — | One or more categories separated by a comma. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "page": { "type": "integer", "description": "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": { "type": "integer", "description": "Number of results returned. Limit 1000" }, "parameters[date]": { "type": "string", "description": "Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest." }, "parameters[date_from]": { "type": "string", "description": "Date to query from point in time." }, "parameters[date_to]": { "type": "string", "description": "Date to query to point in time." }, "parameters[importance]": { "type": "integer", "description": "The importance level to filter by. Uses Greater Than or Equal To the importance indicated", "enum": [ 1, 2, 3 ] }, "parameters[updated]": { "type": "integer", "description": "Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated." }, "country": { "type": "string", "description": "3-Digit Country Code" }, "event_category": { "type": "string", "description": "One or more categories separated by a comma." } }, "required": [ "PCID" ] } ``` *** ## benzinga\_calendar\_get\_fda FDA approvals, clinical trials, and PDUFA dates **Parameters:** | Parameter | Type | Required | Default | Description | | -------------------------------- | ------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `page` | integer | No | — | 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 | No | — | Number of results returned. Limit 1000 | | `parameters[date]` | string | No | — | 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 | No | — | Date to query from point in time. | | `parameters[date_to]` | string | No | — | Date to query to point in time. | | `parameters[date_search_field]` | string | No | — | Date to filter and sort calendar by. Default is `announced`. | | `parameters[date_search_strict]` | boolean | No | — | 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 | No | — | 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 | No | — | Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "page": { "type": "integer", "description": "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": { "type": "integer", "description": "Number of results returned. Limit 1000" }, "parameters[date]": { "type": "string", "description": "Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest." }, "parameters[date_from]": { "type": "string", "description": "Date to query from point in time." }, "parameters[date_to]": { "type": "string", "description": "Date to query to point in time." }, "parameters[date_search_field]": { "type": "string", "description": "Date to filter and sort calendar by. Default is `announced`.", "enum": [ "announced", "target" ] }, "parameters[date_search_strict]": { "type": "boolean", "description": "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]": { "type": "string", "description": "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]": { "type": "integer", "description": "Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated." } }, "required": [ "PCID" ] } ``` *** ## benzinga\_calendar\_get\_guidance Returns guidance data **Parameters:** | Parameter | Type | Required | Default | Description | | ------------------------ | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `page` | integer | No | — | 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 | No | — | Number of results returned. Limit 1000 | | `parameters[date]` | string | No | — | 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 | No | — | Date to query from point in time. | | `parameters[date_to]` | string | No | — | Date to query to point in time. | | `parameters[tickers]` | string | No | — | 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 | No | — | The importance level to filter by. Uses Greater Than or Equal To the importance indicated | | `parameters[updated]` | integer | No | — | 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 | No | — | Determines if guidance returned is primary, secondary or all. Default set to Y. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "page": { "type": "integer", "description": "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": { "type": "integer", "description": "Number of results returned. Limit 1000" }, "parameters[date]": { "type": "string", "description": "Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest." }, "parameters[date_from]": { "type": "string", "description": "Date to query from point in time." }, "parameters[date_to]": { "type": "string", "description": "Date to query to point in time." }, "parameters[tickers]": { "type": "string", "description": "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]": { "type": "integer", "description": "The importance level to filter by. Uses Greater Than or Equal To the importance indicated", "enum": [ 0, 1, 2, 3, 4, 5 ] }, "parameters[updated]": { "type": "integer", "description": "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]": { "type": "string", "description": "Determines if guidance returned is primary, secondary or all. Default set to Y.", "enum": [ "Y", "N", "All" ] } }, "required": [ "PCID" ] } ``` *** ## benzinga\_calendar\_get\_ipos Returns ipo data **Parameters:** | Parameter | Type | Required | Default | Description | | ----------------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `page` | integer | No | — | 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 | No | — | Number of results returned. Limit 1000 | | `parameters[date]` | string | No | — | 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 | No | — | Date to query from point in time. | | `parameters[date_to]` | string | No | — | Date to query to point in time. | | `parameters[ipo_type]` | string | No | — | One or more IPO types separated by a comma. Example: Ordinary Shares,SPAC | | `parameters[tickers]` | string | No | — | 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 | No | — | Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "page": { "type": "integer", "description": "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": { "type": "integer", "description": "Number of results returned. Limit 1000" }, "parameters[date]": { "type": "string", "description": "Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest." }, "parameters[date_from]": { "type": "string", "description": "Date to query from point in time." }, "parameters[date_to]": { "type": "string", "description": "Date to query to point in time." }, "parameters[ipo_type]": { "type": "string", "description": "One or more IPO types separated by a comma. Example: Ordinary Shares,SPAC" }, "parameters[tickers]": { "type": "string", "description": "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]": { "type": "integer", "description": "Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated." } }, "required": [ "PCID" ] } ``` *** ## benzinga\_calendar\_get\_ma Returns the mergers and acquisitions data **Parameters:** | Parameter | Type | Required | Default | Description | | ------------------------ | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `page` | integer | No | — | 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 | No | — | Number of results returned. Limit 1000 | | `parameters[date]` | string | No | — | 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 | No | — | Date to query from point in time. | | `parameters[date_to]` | string | No | — | Date to query to point in time. | | `parameters[tickers]` | string | No | — | 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 | No | — | The importance level to filter by. Uses Greater Than or Equal To the importance indicated | | `parameters[updated]` | integer | No | — | 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 | No | — | M\&A date field to sort on (newest to oldest for expected and completed; oldest to newest for announced) | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "page": { "type": "integer", "description": "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": { "type": "integer", "description": "Number of results returned. Limit 1000" }, "parameters[date]": { "type": "string", "description": "Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest." }, "parameters[date_from]": { "type": "string", "description": "Date to query from point in time." }, "parameters[date_to]": { "type": "string", "description": "Date to query to point in time." }, "parameters[tickers]": { "type": "string", "description": "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]": { "type": "integer", "description": "The importance level to filter by. Uses Greater Than or Equal To the importance indicated", "enum": [ 0, 1, 2, 3, 4, 5 ] }, "parameters[updated]": { "type": "integer", "description": "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]": { "type": "string", "description": "M&A date field to sort on (newest to oldest for expected and completed; oldest to newest for announced)", "enum": [ "expected", "completed", "announced" ] } }, "required": [ "PCID" ] } ``` *** ## benzinga\_calendar\_get\_offerings Returns Secondary Offering data **Parameters:** | Parameter | Type | Required | Default | Description | | ------------------------ | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `page` | integer | No | — | 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 | No | — | Number of results returned. Limit 1000 | | `parameters[date]` | string | No | — | 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 | No | — | Date to query from point in time. | | `parameters[date_to]` | string | No | — | Date to query to point in time. | | `parameters[tickers]` | string | No | — | 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 | No | — | The importance level to filter by. Uses Greater Than or Equal To the importance indicated | | `parameters[updated]` | integer | No | — | Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "page": { "type": "integer", "description": "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": { "type": "integer", "description": "Number of results returned. Limit 1000" }, "parameters[date]": { "type": "string", "description": "Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest." }, "parameters[date_from]": { "type": "string", "description": "Date to query from point in time." }, "parameters[date_to]": { "type": "string", "description": "Date to query to point in time." }, "parameters[tickers]": { "type": "string", "description": "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]": { "type": "integer", "description": "The importance level to filter by. Uses Greater Than or Equal To the importance indicated", "enum": [ 0, 1, 2, 3, 4, 5 ] }, "parameters[updated]": { "type": "integer", "description": "Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated." } }, "required": [ "PCID" ] } ``` *** ## benzinga\_calendar\_get\_ratings Returns analyst ratings data **Parameters:** | Parameter | Type | Required | Default | Description | | ------------------------ | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `fields` | string | No | — | Available fields: - id - date - time - ticker - exchange - name - currency - action\_pt - action\_company - rating\_current - pt\_current - rating\_prior - pt\_prior - pt\_pct\_change - url - url\_calendar - url\_news - analyst - analyst\_id - analyst\_name - ratings\_accuracy - importance - notes - updated Default fields: - id - date - time - ticker - exchange - name - currency - action\_pt - action\_company - rating\_current - pt\_current - rating\_prior - pt\_prior - url - url\_calendar - url\_news - analyst - analyst\_name - importance - notes - updated | | `page` | integer | No | — | 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 | No | — | Number of results returned. Limit 1000 | | `parameters[date]` | string | No | — | 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 | No | — | Date to query from point in time. | | `parameters[date_to]` | string | No | — | Date to query to point in time. | | `parameters[tickers]` | string | No | — | 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 | No | — | The importance level to filter by. Uses Greater Than or Equal To the importance indicated | | `parameters[updated]` | integer | No | — | 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 | No | — | Filter by a specific action\_company (action for rating). Note that all of these terms are precisely defined. | | `parameters[analyst_id]` | string | No | — | One or more analyst ids (analyst\_id) separated by a comma. | | `parameters[firm_id]` | string | No | — | One or more firm ids (firm\_id) separated by a comma. | | `analyst` | string | No | — | A comma separated list of analyst (person) ID's to bring back. Omitting will bring back all available analysts. | | `firm` | string | No | — | A comma separated list of analyst firm ID's to bring back. Omitting will bring back all available firms. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "fields": { "type": "string", "description": "Available fields: - id - date - time - ticker - exchange - name - currency - action_pt - action_company - rating_current - pt_current - rating_prior - pt_prior - pt_pct_change - url - url_calendar - url_news - analyst - analyst_id - analyst_name - ratings_accuracy - importance - notes - updated Default fields: - id - date - time - ticker - exchange - name - currency - action_pt - action_company - rating_current - pt_current - rating_prior - pt_prior - url - url_calendar - url_news - analyst - analyst_name - importance - notes - updated" }, "page": { "type": "integer", "description": "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": { "type": "integer", "description": "Number of results returned. Limit 1000" }, "parameters[date]": { "type": "string", "description": "Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest." }, "parameters[date_from]": { "type": "string", "description": "Date to query from point in time." }, "parameters[date_to]": { "type": "string", "description": "Date to query to point in time." }, "parameters[tickers]": { "type": "string", "description": "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]": { "type": "integer", "description": "The importance level to filter by. Uses Greater Than or Equal To the importance indicated", "enum": [ 0, 1, 2, 3, 4, 5 ] }, "parameters[updated]": { "type": "integer", "description": "Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated." }, "parameters[action]": { "type": "string", "description": "Filter by a specific action_company (action for rating). Note that all of these terms are precisely defined.", "enum": [ "Downgrades", "Maintains", "Reinstates", "Reiterates", "Upgrades", "Assumes", "Initiates Coverage On", "Terminates Coverage On", "Removes", "Suspends", "Firm Dissolved" ] }, "parameters[analyst_id]": { "type": "string", "description": "One or more analyst ids (analyst_id) separated by a comma." }, "parameters[firm_id]": { "type": "string", "description": "One or more firm ids (firm_id) separated by a comma." }, "analyst": { "type": "string", "description": "A comma separated list of analyst (person) ID's to bring back. Omitting will bring back all available analysts." }, "firm": { "type": "string", "description": "A comma separated list of analyst firm ID's to bring back. Omitting will bring back all available firms." } }, "required": [ "PCID" ] } ``` *** ## benzinga\_calendar\_get\_ratings\_analysts Returns the full list of analysts that are providing ratings. **Parameters:** | Parameter | Type | Required | Default | Description | | -------------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `fields` | string | No | — | Default fields: - id - name\_first - name\_last - name\_full - firm\_id - firm\_name - ratings\_accuracy - updated | | `analyst` | string | No | — | A comma separated list of analyst (person) ID's to bring back. Omitting will bring back all available analysts. | | `firm` | string | No | — | A comma separated list of analyst firm ID's to bring back. Omitting will bring back all available firms. | | `firm_name` | string | No | — | A comma separated list of analyst firm names to bring back. Omitting will bring back all available firms. | | `analyst_name` | string | No | — | A comma separated list of analyst names to bring back. Omitting will bring back all available analysts. | | `page` | integer | No | — | 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 | No | — | Number of results returned. Limit 1000. Default 50. | | `updated` | integer | No | — | Records removed after Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "fields": { "type": "string", "description": "Default fields: - id - name_first - name_last - name_full - firm_id - firm_name - ratings_accuracy - updated" }, "analyst": { "type": "string", "description": "A comma separated list of analyst (person) ID's to bring back. Omitting will bring back all available analysts." }, "firm": { "type": "string", "description": "A comma separated list of analyst firm ID's to bring back. Omitting will bring back all available firms." }, "firm_name": { "type": "string", "description": "A comma separated list of analyst firm names to bring back. Omitting will bring back all available firms." }, "analyst_name": { "type": "string", "description": "A comma separated list of analyst names to bring back. Omitting will bring back all available analysts." }, "page": { "type": "integer", "description": "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": { "type": "integer", "description": "Number of results returned. Limit 1000. Default 50." }, "updated": { "type": "integer", "description": "Records removed after Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated." } }, "required": [ "PCID" ] } ``` *** ## benzinga\_calendar\_get\_ratings\_firms Returns the available firms providing analyst ratings **Parameters:** | Parameter | Type | Required | Default | Description | | ---------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `fields` | string | No | — | Available fields: - id - name - currency - homepage - updated Default fields: - id - name | | `firm` | string | No | — | A comma separated list of analyst firm ID's to bring back. Omitting will bring back all available firms. | | `page` | integer | No | — | 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 | No | — | Number of results returned. Limit 1000. Default 50. | | `updated` | integer | No | — | Records removed after Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "fields": { "type": "string", "description": "Available fields: - id - name - currency - homepage - updated Default fields: - id - name" }, "firm": { "type": "string", "description": "A comma separated list of analyst firm ID's to bring back. Omitting will bring back all available firms." }, "page": { "type": "integer", "description": "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": { "type": "integer", "description": "Number of results returned. Limit 1000. Default 50." }, "updated": { "type": "integer", "description": "Records removed after Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated." } }, "required": [ "PCID" ] } ``` *** ## benzinga\_calendar\_get\_removed Returns the removed calendar data **Parameters:** | Parameter | Type | Required | Default | Description | | ---------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `page` | integer | No | — | 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 | No | — | Number of results returned. Limit 1000. Default 50. | | `type` | string | No | — | Calendar type | | `updated` | integer | No | — | Records removed after Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "page": { "type": "integer", "description": "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": { "type": "integer", "description": "Number of results returned. Limit 1000. Default 50." }, "type": { "type": "string", "description": "Calendar type", "enum": [ "ratings", "earnings", "guidance", "ipos", "offerings", "economics", "ma", "splits", "dividends", "conference calls" ] }, "updated": { "type": "integer", "description": "Records removed after Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated." } }, "required": [ "PCID" ] } ``` *** ## benzinga\_calendar\_get\_splits Returns the splits calendar data **Parameters:** | Parameter | Type | Required | Default | Description | | ------------------------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `page` | integer | No | — | 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 | No | — | Number of results returned. Limit 1000 | | `parameters[date]` | string | No | — | 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 | No | — | Date to query from point in time. | | `parameters[date_to]` | string | No | — | Date to query to point in time. | | `parameters[date_search_field]` | string | No | — | Date to filter and sort calendar by. Default is `announced`. | | `parameters[tickers]` | string | No | — | 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 | No | — | The importance level to filter by. Uses Greater Than or Equal To the importance indicated | | `parameters[updated]` | integer | No | — | Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated. | ```json theme={null} { "type": "object", "properties": { "PCID": { "type": "string", "description": "Pink Connect ID for the authenticated connection" }, "page": { "type": "integer", "description": "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": { "type": "integer", "description": "Number of results returned. Limit 1000" }, "parameters[date]": { "type": "string", "description": "Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest." }, "parameters[date_from]": { "type": "string", "description": "Date to query from point in time." }, "parameters[date_to]": { "type": "string", "description": "Date to query to point in time." }, "parameters[date_search_field]": { "type": "string", "description": "Date to filter and sort calendar by. Default is `announced`.", "enum": [ "announced", "ex" ] }, "parameters[tickers]": { "type": "string", "description": "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]": { "type": "integer", "description": "The importance level to filter by. Uses Greater Than or Equal To the importance indicated", "enum": [ 0, 1, 2, 3, 4, 5 ] }, "parameters[updated]": { "type": "integer", "description": "Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated." } }, "required": [ "PCID" ] } ```