기업 식별 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`	문자열	예	현재 회사명과 앞을 0으로 채운 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 시각과 데이터 범위 페이지에서 확인하세요.