Skip to main content
GET
/
timeline
/
{symbol}
Get timeline events
curl --request GET \
  --url https://api.fcontext.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>"
  },
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 100,
    "hasNext": true
  },
  "message": "<string>",
  "timestamp": "<string>",
  "meta": {
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 100,
      "hasNext": true
    }
  }
}

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
required

ISO 8601 timestamp of the response

pagination
object

Pagination information for paginated responses

message
string

Optional success message

meta
object

Optional metadata including pagination, statistics, and additional context