Company Identity API

Resolve one stable Narwhal company ID to its SEC identity, listings, industry code, and former names.

Endpoint and request

SEC API access is not open yet.

REST endpoint

GET /v1/companies/{company_id}

Request

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

MCP uses companies_get with the corresponding arguments below. REST and MCP return the same response schema and share quota accounting.

Parameters

Name	Required	Type	Meaning
`company_id`	Yes	path · opaque Narwhal ID	Stable company identity returned by company search. Ticker and CIK remain aliases, not permanent route identity.

Response

{
  "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"
}

Field	Type	Required	Meaning
`id`	string	Yes	Stable opaque Narwhal company ID.
`name / cik`	strings	Yes	Current company name and zero-padded ten-digit SEC CIK.
`entity_type / sic`	string or object or null	Yes	Source-supplied entity classification and SIC details when present.
`listings`	array	Yes	Current ticker aliases and nullable exchange names.
`former_names`	array	Yes	Source-published former names and nullable validity timestamps.
`as_of`	UTC timestamp	Yes	Snapshot time for the returned identity.

Errors and quota

400 invalid_query — a query, date, form, limit, or cursor is invalid.
401 invalid_api_key — the Bearer key is missing or rejected.
404 company_not_found — the company ID is unknown in the accepted publication.
429 rate_limit_exceeded or quota_exhausted — the shared short-window or monthly allowance is exhausted.
503 companies_unavailable — Companies is disabled, rights are inactive, or no complete accepted publication can be served.

Authentication failures and rejected throttled requests do not consume monthly quota. Successful REST and MCP calls use the same account allowance.

First-release scope

Nullable source fields stay null. Narwhal does not infer missing exchange, entity-type, or industry classifications.

Public issuer count, historical boundary, and freshness are not published yet.