Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Intelligence Bundles API

Get comprehensive company, security, and earnings intelligence in a single API call. Intelligence bundles combine data from multiple endpoints into structured payloads that are easier for applications and agents to use — 75% fewer tokens compared to assembling the same data from raw API calls.

​
Why use this

Agents building company profiles or earnings previews typically need to hit 4-8 separate endpoints and stitch results together. Intelligence bundles do that composition server-side and return a single, token-efficient payload with the same provenance and freshness metadata.
  • One-call composition — company, security, and earnings bundles in a single request
  • 75% fewer tokens — pre-composed payloads eliminate redundant metadata and reduce downstream parsing
  • Ready for agents — structured for LLM workflows without extra post-processing
  • Async query support — long-running intelligence queries return a job ID for polling
  • Provenance preserved — source accession numbers, filing dates, and data lineage stay in the response

​
Quick start

# Company intelligence bundle
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/intelligence/company?ticker=AAPL"

# Security intelligence bundle
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/intelligence/security?ticker=AAPL"

# Earnings preview bundle
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/intelligence/earnings-preview?ticker=AAPL"

​
Example: async intelligence query

# Submit a complex query
curl -X POST -H "x-api-key: $SECAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Compare AAPL and MSFT capital allocation over last 3 years"}' \
  "https://api.secapi.ai/v1/intelligence/query"

# Poll for results
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/intelligence/query/job_abc123"

​
Response shape (company bundle)

{
  "company": {
    "ticker": "AAPL",
    "name": "Apple Inc.",
    "cik": "0000320193",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "exchange": "NASDAQ",
    "marketCap": 2890000000000,
    "latestFiling": {
      "form": "10-K",
      "filedAt": "2023-11-03",
      "periodOfReport": "2023-09-30"
    },
    "financials": {
      "revenue": 383285000000,
      "netIncome": 96995000000,
      "totalAssets": 352583000000
    },
    "topHolders": ["Vanguard Group", "BlackRock", "Berkshire Hathaway"],
    "recentInsiderActivity": 12
  },
  "meta": {
    "bundleVersion": "2024.1",
    "tokenCount": 847,
    "sources": ["10-K:0000320193-23-000077", "13F:Q3-2023"]
  }
}

​
Endpoints

EndpointDescription
GET /v1/intelligence/companyCompany intelligence bundle
GET /v1/intelligence/securitySecurity-level intelligence bundle
GET /v1/intelligence/earnings-previewEarnings preview bundle
POST /v1/intelligence/queryAsync intelligence query
GET /v1/intelligence/query/:jobIdPoll async query result
POST /v1/intelligence/portfolioPortfolio-level intelligence
POST /v1/intelligence/watchlistWatchlist intelligence
POST /v1/intelligence/footnotes/queryStructured footnote analysis
POST /v1/intelligence/country-reportCountry-level macro intelligence

​
Rate limits

Rate limits vary by plan and workload. Intelligence bundles are more compute-intensive than single-endpoint calls, so production clients should handle 429 responses and retry safely.