企業識別API

安定した Narwhal 企業 ID から、SEC 識別情報、上場情報、業種コード、旧社名を解決します。

エンドポイントとリクエスト

Narwhal APIキーで利用できます。

REST エンドポイント

GET /v1/companies/{company_id}

リクエスト

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/cmp_a1b2c3d4e5f678901234567890abcdef" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCPの使用 companies_get 以下の対応する引数を使用します。REST と MCP は同じレスポンススキーマを返し、クォータ計算を共有します。

パラメータ

名前	必須	種別	意味
`company_id`	はい	パス · 不透明な Narwhal ID	企業検索で返される安定した企業識別情報。ティッカーと CIK は別名であり、永続的なルート識別子ではありません。

レスポンス

{
  "id": "cmp_a1b2c3d4e5f678901234567890abcdef",
  "name": "Apple Inc.",
  "cik": "0000320193",
  "entity_type": "operating",
  "sic": {
    "code": "3571",
    "description": "Electronic Computers"
  },
  "listings": [
    {
      "ticker": "AAPL",
      "exchange": "Nasdaq"
    }
  ],
  "former_names": [
    {
      "name": "APPLE COMPUTER INC",
      "from": "1994-01-26T05:00:00Z",
      "to": "2007-01-04T05:00:00Z"
    }
  ],
  "as_of": "2026-08-29T12:00:00Z"
}

フィールド	種別	必須	意味
`id`	文字列	はい	安定した不透明な Narwhal 企業 ID。
`name / cik`	文字列	はい	現在の企業名とゼロ埋めされた10桁のSEC CIK。
`entity_type / sic`	文字列、オブジェクト、または null	はい	存在する場合の、ソースが提供する法人分類と SIC の詳細。
`listings`	配列	はい	現在のティッカー別名とnull許容の取引所名。
`former_names`	配列	はい	ソースが公開する旧名称と null 許容の有効性タイムスタンプ。
`as_of`	UTC タイムスタンプ	はい	返される識別情報のスナップショット時刻。

エラーとクォータ

400 invalid_query — クエリ、日付、フォーム、上限、カーソルが無効です。
401 invalid_api_key — Bearer キーがないか拒否されました。
404 company_not_found — 受け入れ済み公開データに企業 ID がありません。
429 rate_limit_exceeded または quota_exhausted — 共有の短時間枠または月間枠を使い切りました。
503 companies_unavailable — Companies が無効、権利が非アクティブ、または完全な受け入れ済み公開データを提供できません。

認証失敗と拒否されたスロットリング対象リクエストは月間クォータを消費しません。成功したRESTおよびMCP呼び出しは同じアカウント許容量を使用します。

初回リリースの対象範囲

null 許容のソースフィールドは null のままです。Narwhal は欠損した取引所、法人種別、業種分類を推測しません。

カバレッジは受け入れ済み発行体コホートに限定されます。利用可能なスナップショットについて、レスポンスのas_of時刻とカバレッジページを確認してください。