GET
/
timeline
/
{symbol}
Get timeline events
curl --request GET \
  --url https://api.financialcontext.com/timeline/{symbol} \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "id": "timeline_123456",
    "symbol": "AAPL",
    "event_type": "earnings_announcement",
    "title": "Q4 2023 Earnings Call",
    "description": "Apple Inc. will report Q4 2023 financial results and host earnings call",
    "event_datetime": "<string>",
    "end_datetime": "<string>",
    "is_all_day": false,
    "timezone": "America/New_York",
    "importance": "high",
    "status": "completed",
    "url": "https://investor.apple.com/earnings",
    "source": "SEC_EDGAR",
    "external_id": "<string>",
    "expected_impact": "positive",
    "actual_impact": "positive",
    "impact_score": 85,
    "price_change": 5.25,
    "price_change_percent": 3.47,
    "volume_change": 25000000,
    "tags": [
      "earnings",
      "quarterly",
      "conference-call"
    ],
    "participants": [
      "Tim Cook",
      "Luca Maestri"
    ],
    "location": "Cupertino, CA",
    "is_confirmed": true,
    "reminder_minutes": [
      60,
      1440
    ],
    "metadata": {},
    "createdAt": "<string>",
    "updatedAt": "<string>"
  },
  "message": "<string>",
  "timestamp": "2023-11-07T05:31:56Z",
  "meta": {
    "pagination": {
      "currentPage": 1,
      "pageSize": 20,
      "totalItems": 150,
      "totalPages": 8,
      "hasMore": true,
      "hasPrevious": false
    }
  }
}

Authorizations

X-API-Key
string
header
required

Path Parameters

symbol
string
required

Stock symbol (e.g., AAPL, NASDAQ:AAPL)

Required string length: 1 - 20
Example:

"AAPL"

Query Parameters

symbols
string[]

Filter by stock symbols

Example:
["AAPL", "MSFT"]
from
string | null

Start date, format YYYY-MM-DD

Example:

"2023-01-01"

to
string | null

End date, format YYYY-MM-DD

Example:

"2023-12-31"

page
integer
default:1

Page number, starting from 1

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

1

page_size
integer
default:10

Number of items per page, range 1-100

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

10

Response

Timeline events retrieved successfully

Single timeline event response

success
boolean
required

Indicates successful API response

data
object | null
required

Timeline event data Timeline event data structure

timestamp
string<date-time>
required

ISO 8601 timestamp of the response

message
string

Optional success message

meta
object

Optional metadata including pagination, statistics, and additional context