Company News

Cached company news headlines, sourced from Financial Modeling Prep and served only from the database cache. This endpoint requires a Starter plan or higher.

Endpoint

GET /v1/company/{identifier}/news

{identifier} is a ticker or numeric CIK.

Plan requirement

This is a vendor endpoint gated to Starter plans and above. Free-tier keys receive 403 with code upgrade_required:

{
  "detail": {
    "code": "upgrade_required",
    "detail": "Estimates/news/ratios require a Starter plan or higher."
  }
}

Caching and staleness

Reads never proxy a live request to the vendor. News is considered fresh for one hour; older rows are still returned but flagged "stale": true while the scheduler refreshes them. A cache miss returns an empty items list with "stale": false.

Sample request

curl "https://api.financialdataapis.com/v1/company/AAPL/news" \
  -H "X-API-Key: $FDA_KEY"

Sample response

{
  "data_source": "Financial Modeling Prep",
  "items": [
    {
      "id": 1,
      "cik": 320193,
      "ticker": "AAPL",
      "published_at": "2026-01-01T08:30:00Z",
      "title": "Apple reports record quarterly revenue",
      "url": "https://example.com/apple-record-quarter",
      "source": "Example Financial News",
      "summary": "Apple announced record quarterly results...",
      "fetched_at": "2026-01-01T09:00:00Z"
    }
  ],
  "stale": false
}

Error codes

| Status | Code | Meaning | | --- | --- | --- | | 401 | key_invalid | Missing or invalid API key. | | 403 | upgrade_required | Free-tier key; Starter plan required. | | 404 | — | Unknown ticker or CIK: {id}. | | 429 | MONTHLY_QUOTA_EXCEEDED | Monthly quota exhausted. |