---
title: "GetCompanyEnrichment"
method: GET
path: "/api/intelligence/v1/get-company-enrichment"
tags: ["IntelligenceService"]
---

# GetCompanyEnrichment

`GET /api/intelligence/v1/get-company-enrichment`

## Request

- Base URL: `https://api.worldmonitor.app`
- URL: `https://api.worldmonitor.app/api/intelligence/v1/get-company-enrichment`
- Auth: one of:
  - API key in header `X-WorldMonitor-Key`
  - API key in header `X-Api-Key`

GetCompanyEnrichment aggregates a per-company intelligence composite: SEC EDGAR identity and recent filings (via authoritative ticker-to-CIK resolution), market profile and earnings surprises from Finnhub, and recent news mentions.

## Query parameters

- `domain` string
- `name` string
- `ticker` string
- `jmespath` string

## Response `200`

OK

- WorldmonitorIntelligenceV1GetCompanyEnrichmentResponse: Company enrichment composite aggregated from SEC EDGAR (identity + filings), Finnhub (market profile + earnings surprises), and the news corpus (mentions).
  - `company` WorldmonitorIntelligenceV1EnrichedCompany
    - `name` string
    - `domain` string
    - `description` string: Industry classification (SEC SIC description).
    - `location` string: Business location, such as "Cupertino, CA".
    - `website` string
    - `founded` integer: Deprecated compatibility field; always 0 because no authoritative source in this composite provides founding year.
    - `cik` string: SEC Central Index Key (zero-padded 10 digits), empty when no EDGAR match.
    - `ticker` string: Resolved primary ticker symbol.
  - `github` WorldmonitorIntelligenceV1EnrichedGithub
    - `publicRepos` integer
    - `followers` integer
    - `avatarUrl` string
  - `techStack` WorldmonitorIntelligenceV1TechStackItem[]
    - `name` string
    - `category` string
    - `confidence` number, float
  - `secFilings` WorldmonitorIntelligenceV1SecFilings
    - `totalFilings` integer: Total filings known for this CIK in the recent EDGAR submissions window.
    - `recentFilings` WorldmonitorIntelligenceV1SecFiling[]
      - `form` string
      - `fileDate` string
      - `description` string
      - `url` string: Link to the filing index on sec.gov.
      - `items` string[]
  - `hackerNewsMentions` WorldmonitorIntelligenceV1HNMention[]
    - `title` string
    - `url` string
    - `points` integer
    - `comments` integer
    - `createdAtMs` integer: Warning: Values > 2^53 may lose precision in JavaScript
  - `enrichedAtMs` integer: Warning: Values > 2^53 may lose precision in JavaScript
  - `sources` string[]
  - `market` WorldmonitorIntelligenceV1CompanyMarketProfile
    - `exchange` string
    - `industry` string: Industry classification from Finnhub.
    - `marketCapMusd` number, double: Market capitalization in millions of USD.
    - `ipoDate` string: IPO date (YYYY-MM-DD), empty when unknown.
    - `logoUrl` string
    - `country` string: Company headquarters country code.
    - `currency` string
  - `earningsSurprises` WorldmonitorIntelligenceV1EarningsSurprise[]
    - `period` string: Fiscal period end date (YYYY-MM-DD).
    - `actualEps` number, double
    - `estimateEps` number, double
    - `surprise` number, double: actual minus estimate.
    - `surprisePercent` number, double
    - `year` integer
    - `quarter` integer
  - `newsMentions` WorldmonitorIntelligenceV1CompanyNewsMention[]
    - `title` string
    - `url` string
    - `source` string
    - `publishedAtMs` integer: Warning: Values > 2^53 may lose precision in JavaScript
  - `unavailable` boolean: True when identity could not be resolved because the SEC registry was unreadable, or when a resolved company's enrichment sources all failed. Responses with this set are never cached.

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key.
- `403`: API access requires an active subscription (the API key's subscription is inactive or expired).
- `429`: Rate limit exceeded.
- `503`: Service unavailable. Billing-verification responses include code and X-Billing-Verification; other gateway infrastructure failures use the generic GatewayError shape.
- `default`: Gateway or handler error response.

---

[API](https://skmtc.dev/worldmonitor/apis/worldmonitor-api.md) · [All operations](https://skmtc.dev/worldmonitor/apis/worldmonitor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/worldmonitor/apis/worldmonitor-api/revisions/e3dc8463a5c9?raw)