SEC 신고서 API

10-K, 10-Q, 8-K, Form 4 및 13F-HR을 포함한 SEC 신고서 메타데이터를 기업별로 나열합니다.

엔드포인트 및 요청

Narwhal API 키로 사용할 수 있습니다.

REST 엔드포인트

GET /v1/companies/{company_id}/filings

요청

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/cmp_a1b2c3d4e5f678901234567890abcdef/filings?forms=10-K,10-Q&filed_from=2020-01-01&filed_to=2027-01-01&limit=50" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCP 사용 항목 companies_list_filings 아래 대응 인수와 함께 사용합니다. REST와 MCP는 동일한 응답 스키마를 반환하고 할당량 계산을 공유합니다.

매개변수

이름	필수	유형	의미
`company_id`	예	경로 · 불투명 Narwhal ID	기업 검색이 반환하는 안정적인 기업 식별 정보입니다. 티커와 CIK는 별칭으로 유지되며 영구적인 경로 식별자가 아닙니다.
`forms`	아니요	쿼리 · 쉼표로 구분된 SEC 서식	대소문자를 구분하는 정확한 서식 토큰입니다. 수정 신고서가 제외되지 않는 한 기본 서식은 /A 수정 신고서에도 일치합니다.
`filed_from`	아니요	쿼리 · YYYY-MM-DD	신고일의 포함 하한입니다.
`filed_to`	아니요	쿼리 · YYYY-MM-DD	신고일의 배타적 상한입니다. filed_from보다 늦어야 합니다.
`include_amendments`	아니요	쿼리 · 불리언	기본 서식을 요청하면 수정 신고서를 포함합니다. 기본값은 true입니다.
`limit`	아니요	쿼리 · 정수, 1~100	반환할 최대 신고서 수입니다. 기본값은 50입니다.
`cursor`	아니요	쿼리 · 불투명 문자열	이전 페이지의 연속 토큰입니다. 원래 쿼리와 필터에 연결되어 있습니다.

SEC 서식 필터

정확한 SEC 서식 토큰을 사용하세요. 기본 서식은 다음을 포함할 수 있습니다 /A 다음과 같은 수정 신고서 10-K/A 또는 4/A, 단 수정 사항을 제외하는 경우는 예외입니다.

서식	의미
`10-K`	연차 기업 보고서
`10-Q`	분기별 기업 보고서
`8-K`	중요 기업 사건
`20-F / 6-K`	외국 민간 발행자 보고서
`DEF 14A`	대리 투표, 이사회 및 경영진 보수
`Forms 3 / 4 / 5`	내부자 실질 소유권 및 변경 사항
`Schedule 13D / 13G`	대규모 실질 소유자
`13F-HR`	기관 관리자 보유 내역
`S-1 / S-3 / 424B`	등록, 공모 및 투자설명서

이 목록은 일반적인 서식을 설명합니다. 고정된 허용 목록이 아닙니다.

응답

{
  "company": {
    "id": "cmp_a1b2c3d4e5f678901234567890abcdef",
    "name": "Apple Inc.",
    "cik": "0000320193"
  },
  "filings": [
    {
      "accession_number": "0000320193-24-000123",
      "form": "10-K",
      "filed_on": "2024-11-01",
      "accepted_at": "2024-11-01T10:01:36Z",
      "report_period": "2024-09-28",
      "is_amendment": false,
      "items": [],
      "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.html",
      "primary_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T12:00:00Z"
}

필드	유형	필수	의미
`company`	객체	예	요청한 발행자의 안정적인 회사 ID, 이름 및 CIK입니다.
`filings`	배열	예	신고서 메타데이터를 접수 시각과 접수 번호 순으로 최신 항목부터 정렬합니다.
`next_cursor`	문자열 또는 null	예	필터에 연결된 불투명한 연속 토큰이며 완료되면 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 호출은 동일한 계정 한도를 사용합니다.

최초 발표 범위

첫 번째 릴리스는 메타데이터와 표준 SEC 문서 링크만 반환합니다. 신고서 본문, 첨부 자료, XBRL 팩트, 내부자 거래, 재무제표 또는 13F 보유 내역은 포함하지 않습니다.

데이터 범위는 승인된 발행자 집합으로 제한됩니다. 이용 가능한 스냅샷은 응답의 as_of 시각과 데이터 범위 페이지에서 확인하세요.