GetCompanyEnrichment

curl --request GET \
  --url https://api.worldmonitor.app/api/intelligence/v1/get-company-enrichment \
  --header 'X-WorldMonitor-Key: <api-key>'

import requests

url = "https://api.worldmonitor.app/api/intelligence/v1/get-company-enrichment"

headers = {"X-WorldMonitor-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-WorldMonitor-Key': '<api-key>'}};

fetch('https://api.worldmonitor.app/api/intelligence/v1/get-company-enrichment', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.worldmonitor.app/api/intelligence/v1/get-company-enrichment",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-WorldMonitor-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.worldmonitor.app/api/intelligence/v1/get-company-enrichment"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-WorldMonitor-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.worldmonitor.app/api/intelligence/v1/get-company-enrichment")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-WorldMonitor-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "company": {
    "cik": "0000320193",
    "description": "Electronic Computers",
    "domain": "apple.com",
    "founded": 0,
    "location": "Cupertino, CA",
    "name": "Apple Inc.",
    "ticker": "AAPL",
    "website": "https://www.apple.com"
  },
  "earningsSurprises": [
    {
      "actualEps": 1.57,
      "estimateEps": 1.43,
      "period": "2026-06-30",
      "quarter": 3,
      "surprise": 0.14,
      "surprisePercent": 9.79,
      "year": 2026
    }
  ],
  "enrichedAtMs": 1784908800000,
  "hackerNewsMentions": [],
  "market": {
    "country": "US",
    "currency": "USD",
    "exchange": "NASDAQ NMS - GLOBAL MARKET",
    "industry": "Technology",
    "ipoDate": "1980-12-12",
    "logoUrl": "https://static2.finnhub.io/file/publicdatany/finnhubimage/stock_logo/AAPL.png",
    "marketCapMusd": 3200000
  },
  "newsMentions": [
    {
      "publishedAtMs": 1784905200000,
      "source": "example.com",
      "title": "Apple reports quarterly results",
      "url": "https://example.com/apple-results"
    }
  ],
  "secFilings": {
    "recentFilings": [
      {
        "description": "Results of Operations and Financial Condition",
        "fileDate": "2026-07-24",
        "form": "8-K",
        "items": [
          "2.02"
        ],
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000070/0000320193-26-000070-index.htm"
      }
    ],
    "totalFilings": 120
  },
  "sources": [
    "sec_edgar",
    "finnhub",
    "news"
  ],
  "techStack": [],
  "unavailable": false
}

{
  "violations": [
    {
      "field": "<string>",
      "description": "<string>"
    }
  ]
}

{
  "error": "<string>"
}

{
  "error": "<string>",
  "code": "subscription_lapsed",
  "requiredTier": 123,
  "currentTier": 123,
  "planKey": "<string>"
}

{
  "message": "<string>"
}

{
  "error": "<string>",
  "code": "renewal_verification_pending",
  "requiredTier": 123
}

{
  "message": "<string>"
}

GET

api

intelligence

get-company-enrichment

GetCompanyEnrichment

curl --request GET \
  --url https://api.worldmonitor.app/api/intelligence/v1/get-company-enrichment \
  --header 'X-WorldMonitor-Key: <api-key>'

import requests

url = "https://api.worldmonitor.app/api/intelligence/v1/get-company-enrichment"

headers = {"X-WorldMonitor-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-WorldMonitor-Key': '<api-key>'}};

fetch('https://api.worldmonitor.app/api/intelligence/v1/get-company-enrichment', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.worldmonitor.app/api/intelligence/v1/get-company-enrichment",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-WorldMonitor-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.worldmonitor.app/api/intelligence/v1/get-company-enrichment"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-WorldMonitor-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.worldmonitor.app/api/intelligence/v1/get-company-enrichment")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-WorldMonitor-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "company": {
    "cik": "0000320193",
    "description": "Electronic Computers",
    "domain": "apple.com",
    "founded": 0,
    "location": "Cupertino, CA",
    "name": "Apple Inc.",
    "ticker": "AAPL",
    "website": "https://www.apple.com"
  },
  "earningsSurprises": [
    {
      "actualEps": 1.57,
      "estimateEps": 1.43,
      "period": "2026-06-30",
      "quarter": 3,
      "surprise": 0.14,
      "surprisePercent": 9.79,
      "year": 2026
    }
  ],
  "enrichedAtMs": 1784908800000,
  "hackerNewsMentions": [],
  "market": {
    "country": "US",
    "currency": "USD",
    "exchange": "NASDAQ NMS - GLOBAL MARKET",
    "industry": "Technology",
    "ipoDate": "1980-12-12",
    "logoUrl": "https://static2.finnhub.io/file/publicdatany/finnhubimage/stock_logo/AAPL.png",
    "marketCapMusd": 3200000
  },
  "newsMentions": [
    {
      "publishedAtMs": 1784905200000,
      "source": "example.com",
      "title": "Apple reports quarterly results",
      "url": "https://example.com/apple-results"
    }
  ],
  "secFilings": {
    "recentFilings": [
      {
        "description": "Results of Operations and Financial Condition",
        "fileDate": "2026-07-24",
        "form": "8-K",
        "items": [
          "2.02"
        ],
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000070/0000320193-26-000070-index.htm"
      }
    ],
    "totalFilings": 120
  },
  "sources": [
    "sec_edgar",
    "finnhub",
    "news"
  ],
  "techStack": [],
  "unavailable": false
}

{
  "violations": [
    {
      "field": "<string>",
      "description": "<string>"
    }
  ]
}

{
  "error": "<string>"
}

{
  "error": "<string>",
  "code": "subscription_lapsed",
  "requiredTier": 123,
  "currentTier": 123,
  "planKey": "<string>"
}

{
  "message": "<string>"
}

{
  "error": "<string>",
  "code": "renewal_verification_pending",
  "requiredTier": 123
}

{
  "message": "<string>"
}

Authorizations

X-WorldMonitor-Key

string

header

required

User-issued WorldMonitor API key.

Query Parameters

domain

string

Deprecated compatibility input. Domain attribution remains disabled and returns the legacy empty stub; use ticker or name for verified CIK lookup.

name

string

Company name, such as "Apple Inc".

ticker

string

Exchange ticker symbol, such as "AAPL". Preferred lookup key.

jmespath

string

Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.

Response

Successful response

Company enrichment composite aggregated from SEC EDGAR (identity + filings), Finnhub (market profile + earnings surprises), and the news corpus (mentions).

company

object

Show child attributes

github

object

deprecated

Show child attributes

techStack

object[]

deprecated

Show child attributes

secFilings

object

Show child attributes

hackerNewsMentions

object[]

deprecated

Show child attributes

enrichedAtMs

integer<int64>

Unix timestamp in milliseconds when this data was fetched.. Warning: Values > 2^53 may lose precision in JavaScript

sources

string[]

List of sources successfully reached (e.g. "sec_edgar", "finnhub", "news").

market

object

Show child attributes

earningsSurprises

object[]

Show child attributes

newsMentions

object[]

Show child attributes

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.