Skip to main content
GET
/
api
/
v1
/
events
Get Events
curl --request GET \
  --url 'https://api.finvera.news/delivery/api/v1/events?apikey='
{
  "data": [
    {
      "event_id": "4be8fed5-f9db-41ef-a107-c20c3339998d",
      "title": "Example Corp reports Q1 earnings beat",
      "headline": "Example Corp tops Q1 estimates on strong product demand.",
      "description": "Example Corp reported quarterly earnings that exceeded analyst expectations, driven by higher product demand and improved operating margins.",
      "symbol": "EXMP",
      "exchange": "XNAS",
      "figis": [
        "BBG000BXXXXX"
      ],
      "event_type": "EARNINGS",
      "source": "PRESS_RELEASE",
      "sentiment": 0.82,
      "occurred_at": "2025-04-23T11:34:15-04:00",
      "created_at": "2025-04-23T15:34:15Z",
      "updated_at": "2025-04-23T15:34:15Z",
      "securities": [
        {
          "figi": "BBG000BXXXXX",
          "isin": "US0000000000",
          "name": "EXAMPLE CORP",
          "symbol": "EXMP",
          "mic_code": "XNAS",
          "figi_composite": "BBG000BXXXXX",
          "figi_share_class": "BBG001SXXXXX",
          "refinitiv_exch_code": "NAS"
        }
      ]
    }
  ],
  "message": "Successfully fetched events",
  "pagination": {
    "hits": 1,
    "page": 1,
    "page_count": 1,
    "page_size": 18
  }
}
{
  "data": [
    {
      "event_id": "4be8fed5-f9db-41ef-a107-c20c3339998d",
      "title": "Example Corp reports Q1 earnings beat",
      "headline": "Example Corp tops Q1 estimates on strong product demand.",
      "description": "Example Corp reported quarterly earnings that exceeded analyst expectations, driven by higher product demand and improved operating margins.",
      "symbol": "EXMP",
      "exchange": "XNAS",
      "figis": [
        "BBG000BXXXXX"
      ],
      "event_type": "EARNINGS",
      "source": "PRESS_RELEASE",
      "sentiment": 0.82,
      "occurred_at": "2025-04-23T11:34:15-04:00",
      "created_at": "2025-04-23T15:34:15Z",
      "updated_at": "2025-04-23T15:34:15Z",
      "securities": [
        {
          "figi": "BBG000BXXXXX",
          "isin": "US0000000000",
          "name": "EXAMPLE CORP",
          "symbol": "EXMP",
          "mic_code": "XNAS",
          "figi_composite": "BBG000BXXXXX",
          "figi_share_class": "BBG001SXXXXX",
          "refinitiv_exch_code": "NAS"
        }
      ]
    }
  ],
  "message": "Successfully fetched events",
  "pagination": {
    "hits": 1,
    "page": 1,
    "page_count": 1,
    "page_size": 18
  }
}

Authorizations

apikey
string
query
required

Query Parameters

symbol
string

Filter by stock symbol

Example:

"AAPL"

from
string

from date in ISO 8601 format, YYYY-MM-DDTHH:MM:SS

Example:

"2025-05-02T00:00:00"

to
string

to date in ISO 8601 format, YYYY-MM-DDTHH:MM:SS

Example:

"2025-05-02T00:00:00"

page
integer

page number for pagination

Example:

"1"

page_size
integer
default:10

page size for pagination

Example:

"18"

securities
boolean

include linked securities data in the response

Example:

true

Response

OK

data
object[]
message
string

A message indicating the status of the request.

pagination
object