Analyst Estimates

Cached revenue and EPS estimates plus price targets for a company, 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}/estimates

{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. Data is considered fresh for 24 hours; older rows are still returned but flagged "stale": true. A cache miss returns an empty items list with "stale": false.

Sample request

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

Sample response

{
  "data_source": "Financial Modeling Prep",
  "items": [
    {
      "id": 1,
      "cik": 320193,
      "ticker": "AAPL",
      "period": "2026-09-30",
      "estimated_revenue": 410000000000,
      "estimated_eps": 7.4,
      "price_target_low": 210,
      "price_target_high": 300,
      "price_target_avg": 255,
      "analysts_count": 42,
      "fetched_at": "2026-01-01T12: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. |