공시 본문과 세그먼트 API 레퍼런스
미국 공시의 본문을 항목별로, 세그먼트, 제품, 지역별 수치
개요
공시 본문은 미국 기업이 10-K, 10-Q, 20-F 또는 8-K에 쓴 내용을 Item 1A 위험 요인이나 Item 7 경영진 논의 같은 항목 제목 단위로 나누어 반환합니다. 세그먼트는 기업이 세그먼트, 제품 또는 지역별로 나눈 수치를 재무제표에 더합니다. 모든 요청에 Bearer 키가 필요하며, REST와 MCP는 하나의 크레딧 잔액을 함께 사용합니다.
경로는 네 개입니다. 둘은 공시 한 건의 본문을 반환하는데, 하나는 공시 ID로, 다른 하나는 기업, 양식, 회계연도로 조회합니다. 하나는 양식마다 있는 항목을 나열합니다. 네 번째는 재무 경로의 segments=true이며, 경로 이름과 가격은 그대로입니다. 기업은 공시 API의 ID로 지정하며, 예를 들면 usa:0000320193입니다. 공시는 기업 ID, 콜론, SEC 접수번호로 지정합니다.
이력은 5년 전까지입니다. 본문을 아직 읽지 않은 공시는 404 sections_이며, 해당 기간 자체의 보고서를 세그먼트용으로 아직 읽지 않은 기간은 segments_에 나열됩니다.
본문 경로는 미국, 일본, 한국을 지원합니다. 미국 공시는 10-K, 10-Q, 20-F, 8-K입니다. 일본 공시는 YUHO, HANKI, SHIHANKI, RINJI이고, 한국 공시는 사업보고서, 반기보고서, 분기보고서입니다. 기업의 국가가 아닌 다른 국가의 양식은 400 invalid_입니다. 그 밖의 국가의 기업은 404 not_입니다. 본문을 아직 읽지 않은 일본 또는 한국 공시는 404 sections_입니다. 세그먼트는 미국 기업에만 해당합니다.
기본 URL: https:/. 아래 각 경로는 같은 매개변수를 가진 별도의 MCP 도구입니다.
각 재무제표의 행은 다음 페이지에 있습니다: 기업 공시 API로 재무 정보 조회.
기업 ID는 공시 API 기업 검색이 반환하는 값입니다.
모든 계정에 제공되는 것
| 항목 | 모든 계정 |
|---|---|
| 공시 본문, 경로 2개 | 포함 |
| 항목 목록 | 포함, 무료 |
| 재무의 세그먼트 | 포함 |
확인 요금 페이지에서 호출당 비용을 확인할 수 있습니다. 라우트에 별도 안내가 없으면 요청은 해당 API의 가격으로 청구됩니다.
- Companies 가격으로 청구되며 호출 1,000회당 $10입니다. 성공한 본문 응답은 항목, 크기, 형식과 관계없이 호출 1회입니다. 기업으로 조회하는 8-K는 항목을 찾으려고 최신 8-K를 최대 10건까지 읽지만 그래도 호출 1회입니다. 내용이 없는 응답은 무료이며, 본문 경로에서 아무것도 찾지 못하면 404이고 이것도 무료입니다. 항목 목록은 무료입니다. 오류는 청구되지 않습니다.
segments=true는 호출도 가격도 늘리지 않습니다. 이를 붙인 재무 응답도 붙이지 않은 것과 같은 호출 1회입니다. 재무 행이 있는 응답은segments에 행이 있든, 비어 있든, 생략되었든 호출 1회로 청구됩니다.- 본문은 공시 자체의 내용을 항목 제목 단위로 나눈 것입니다. 다시 쓰거나 요약하지 않습니다. 항목을 구분하지 못한 공시는 404
sections_이며, 일부만 반환하는 일은 없습니다.unavailable - 10-Q에는 Part I에 Item 1이 있고 Part II에도 Item 1이 있습니다.
part없이item=1을 보내면 둘 다 반환합니다. item없이 요청한 8-K는 첨부 서류의 본문도exhibits로 반환합니다. 본문이 잘린 첨부 서류에서는truncated가 true입니다.- 세그먼트 행은 해당 기간 자체의 보고서에 제출된 그대로의 수치를 나타냅니다.
value와 그 수치가 제출된filing_입니다. 이후 공시가 수치를 바꾼 경우id restated에 이후 수치와 그 출처 공시가 들어갑니다.version=first_는 제출 당시 수치만 반환합니다.reported restated_행에는only value도filing_도 없습니다. 제출 당시 수치를 보유하고 있지 않기 때문입니다. 해당 기간의 보고서에 그 멤버가 없는 경우(이후 공시가 기간을 다른 멤버로 다시 나누었기 때문)이거나, 보고서를 아직 읽지 않은 경우입니다. 뒤의 경우id restated는 이후 공시의 수치이며 재작성이 아닐 수도 있습니다.segments_는 해당 기간 자체의 보고서를 세그먼트용으로 아직 읽지 않은 기간의 종료일을 최신순으로 나열합니다. 제출 당시 수치가 없다는 것은 제출이 없었다는 뜻과 다릅니다. 이런 기간의 행이 있다면unread restated_입니다. 읽은 기간이 없고 이후 공시에도 수치가 없으면only segments는 생략됩니다.member와label은 세그먼트, 제품, 지역에 대해 기업이 직접 쓰는 표현이며, 기업 간에 맞추지 않습니다.concept는 기업이 사용한 태그이므로, 같은measure의 두 수치(예: 세그먼트 간 매출을 포함한 매출과 제외한 매출)는 따로 유지됩니다.percent_은of_ total filing_가 가리키는 공시에서 같은 개념과 기간의 연결 수치에 대한 그 수치의 비율(퍼센트)이며, 소수 둘째 자리까지입니다. 제출자가 소계와 연결 멤버를 더하기 때문에 멤버의 합이 항상 100이 되는 것은 아닙니다. 그 공시에 해당 개념과 기간의 연결 수치가 인쇄되어 있지 않으면 생략됩니다.id - 세그먼트 수치는
currency의 통화 단위 그대로입니다. 자산이나 영업권처럼 특정 날짜의 수치에는start가 없습니다.
엔드포인트
모든 경로는 GET이며, 키를 다음 헤더에 담아 보내야 합니다: Authorization: Bearer 헤더입니다. 예시는 응답의 형태를 보여 줄 뿐이며 실시간 데이터가 아닙니다.
항목별 공시 본문 조회
GET /v1/filings/{filing_id}/sections
공시 한 건의 본문을 항목 제목 단위로 나누어 반환합니다. 모든 항목이거나 item으로 지정한 항목 하나입니다. 미국의 10-K, 10-Q, 20-F, 8-K 또는 일본이나 한국의 보고서입니다. 항목을 구분하지 못한 공시는 404 sections_이며, 일부만 반환하는 일은 없습니다.
MCP: 도구 filings_.
매개변수
| 매개변수 | 위치 | 필수 | 유형 | 의미 |
|---|---|---|---|---|
filing_ | 경로 | 예 | 문자열 | 공시 ID이며 기업 ID, 콜론, SEC 접수번호로 이루어집니다. 예: usa:0000320193:0000320193-26-000026. 공시 API에서 나열할 수 있습니다. |
item | 쿼리 | 아니요 | 문자열 | 번호로 지정하는 항목 하나입니다. 예: 1A 또는 7. 8-K 항목은 2.02 같은 형태입니다. 생략하면 모든 항목을 반환합니다. 공시에 없는 항목은 404 item_입니다. |
part | 쿼리 | 아니요 | 문자열 | 부(I부터 IV까지). 10-Q에는 Part I에 Item 1이 있고 Part II에도 Item 1이 있습니다. part 없이 item을 보내면 둘 다 반환합니다. |
응답 필드
| 필드 | 유형 | 전송 | 의미 |
|---|---|---|---|
id | 문자열 | 항상 | 공시 ID입니다. 재무 응답에서는 기업 ID입니다. |
form | 문자열 | 항상 | 공시의 양식입니다. 예: 10-K. |
sections | 객체 목록 | 항상 | 공시의 항목이며 공시에 나온 순서입니다. |
sections[].item | 문자열 | 항상 | 항목 번호입니다. 예: 1A, 8-K에서는 2.02. |
sections[].title | 문자열 | 항상 | 항목의 제목입니다. 예: Risk Factors. |
sections[].text | 문자열 | 항상 | 제출된 그대로의 항목 본문입니다. |
sections[].part | 문자열 | 선택 | 항목이 속한 부이며 I부터 IV까지입니다. 양식에 부가 없으면 생략합니다. |
exhibits | 객체 목록 | 선택 | 8-K의 첨부 서류 파일을 텍스트로 옮긴 것입니다. item을 생략하면 보냅니다. |
exhibits[].type | 문자열 | 항상 | 첨부 서류의 유형입니다. 예: EX-99.1. |
exhibits[].name | 문자열 | 항상 | 첨부 서류의 파일 이름입니다. |
exhibits[].text | 문자열 | 항상 | 첨부 서류의 본문입니다. |
exhibits[].truncated | 불리언 | 선택 | 본문이 잘렸으면 true입니다. |
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/filings/usa:0000320193:0000320193-26-000026/sections?item=1A"{
"id": "usa:0000320193:0000320193-26-000026",
"form": "10-K",
"sections": [
{
"item": "1A",
"title": "Risk Factors",
"text": "The following summarizes factors that could have a material adverse effect on the Company’s business, reputation, results of operations, financial condition and…",
"part": "I"
}
]
}기업의 공시 본문을 양식과 연도로 조회
GET /v1/companies/{company_id}/sections
공시 경로와 같은 본문을 기업, 양식, 회계연도로 찾으므로 공시 ID가 필요 없습니다. year를 생략하면 그 양식의 최신 공시입니다. item을 지정한 8-K는 기업의 최근 8-K 10건 중 그 항목이 있는 가장 최신 건입니다.
form=10-Q와 함께 quarter를 사용해 분기를 고릅니다. 다른 양식과 함께 쓰면 400 invalid_입니다.
MCP: 도구 filings_.
매개변수
| 매개변수 | 위치 | 필수 | 유형 | 의미 |
|---|---|---|---|---|
company_ | 경로 | 예 | 문자열 | 기업 ID입니다. 예: usa:0000320193. usa:AAPL 같은 티커 별칭도 사용할 수 있습니다. |
form | 쿼리 | 예 | one of 10-K, 10-Q, 20-F, 8-K, YUHO, HANKI, SHIHANKI, RINJI, 사업보고서, 반기보고서, 분기보고서 | 기업의 국가가 부르는 이름으로 쓴 양식입니다. 미국은 10-K, 10-Q, 20-F, 8-K, 일본은 YUHO, HANKI, SHIHANKI, RINJI, 한국은 사업보고서, 반기보고서, 분기보고서입니다. 그 밖의 값은 400 invalid_입니다. |
year | 쿼리 | 아니요 | 정수 | 10-K, 10-Q, 20-F는 회계연도, 8-K는 제출된 연도입니다. 생략하면 최신 공시입니다. |
quarter | 쿼리 | 아니요 | 정수 | 회계 분기이며 분기 보고서(10-Q, SHIHANKI, 분기보고서)에만 씁니다. |
item | 쿼리 | 아니요 | 문자열 | 항목 하나, 예: 1A. 8-K의 경우 기업의 최근 8-K 10건 중 그 항목이 있는 가장 최신 건이 반환됩니다(8-K는 사건 하나를 보고하므로 최신 건에 그 항목이 없는 경우가 많습니다). item을 생략하면 최신 8-K입니다. |
part | 쿼리 | 아니요 | 문자열 | 부, I부터 IV까지입니다. 10-Q에는 Part I에 Item 1이 있고 Part II에도 Item 1이 있습니다. part 없이 item을 보내면 둘 다 반환합니다. |
응답 필드
| 필드 | 유형 | 전송 | 의미 |
|---|---|---|---|
id | 문자열 | 항상 | 공시 ID입니다. 재무 응답에서는 기업 ID입니다. |
form | 문자열 | 항상 | 공시의 양식입니다. 예: 10-K. |
sections | 객체 목록 | 항상 | 공시의 항목이며 공시에 나온 순서입니다. |
sections[].item | 문자열 | 항상 | 항목 번호입니다. 예: 1A, 8-K에서는 2.02. |
sections[].title | 문자열 | 항상 | 항목의 제목입니다. 예: Risk Factors. |
sections[].text | 문자열 | 항상 | 제출된 그대로의 항목 본문입니다. |
sections[].part | 문자열 | 선택 | 항목이 속한 부이며 I부터 IV까지입니다. 양식에 부가 없으면 생략합니다. |
exhibits | 객체 목록 | 선택 | 8-K의 첨부 서류 파일을 텍스트로 옮긴 것입니다. item을 생략하면 보냅니다. |
exhibits[].type | 문자열 | 항상 | 첨부 서류의 유형입니다. 예: EX-99.1. |
exhibits[].name | 문자열 | 항상 | 첨부 서류의 파일 이름입니다. |
exhibits[].text | 문자열 | 항상 | 첨부 서류의 본문입니다. |
exhibits[].truncated | 불리언 | 선택 | 본문이 잘렸으면 true입니다. |
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/companies/usa:0000320193/sections?form=8-K"{
"id": "usa:0000320193:0001140361-26-042798",
"form": "8-K",
"sections": [
{
"item": "8.01",
"title": "Other Events",
"text": "Other Events.\nOn November 9, 2026, Apple Inc. (“Apple”) consummated the issuance and sale of $500,000,000 aggregate principal amount of its Floating Rate Notes…"
},
{
"item": "9.01",
"title": "Financial Statements and Exhibits",
"text": "Financial Statements and Exhibits.\n(d) Exhibits.\nExhibit\nNumber\nExhibit Description\n1.1 Underwriting Agreement, dated November 5, 2026, among Apple Inc. and Gol…"
}
],
"exhibits": [
{
"type": "EX-1.1",
"name": "ef20085077_ex1-1.htm",
"text": "EX-1.1 2 ef20085077_ex1-1.htm EXHIBIT 1.1\nExhibit 1.1\nApple Inc.\n$500,000,000 Floating Rate Notes due 2028\n$750,000,000 Floating Rate Notes due 2029\n$1,000,000,…"
},
{
"type": "EX-4.1",
"name": "ef20085077_ex4-1.htm",
"text": "EX-4.1 3 ef20085077_ex4-1.htm EXHIBIT 4.1\nExhibit 4.1\nAPPLE INC.\nOfficer’s Certificate\nPursuant to Sections 102 and 301 of the Indenture, dated as of November 1…"
}
]
}양식별 항목 목록 조회
GET /v1/filings/sections/items
본문 경로가 반환할 수 있는 항목을 양식별로 항목, 부, 제목으로 보여줍니다. 무료입니다. 이 경로는 청구되지 않습니다.
먼저 항목을 조회한 다음, 그중 하나를 본문 경로의 item으로 전달합니다.
MCP: 도구 filings_.
매개변수
| 매개변수 | 위치 | 필수 | 유형 | 의미 |
|---|---|---|---|---|
form | 쿼리 | 아니요 | one of 10-K, 10-Q, 20-F, 8-K, YUHO, HANKI, SHIHANKI, RINJI, 사업보고서, 반기보고서, 분기보고서 | 한 양식의 항목이며 위 세 목록 중 어느 것이든 됩니다. 생략하면 미국 양식 네 가지의 항목입니다. |
응답 필드
| 필드 | 유형 | 전송 | 의미 |
|---|---|---|---|
items | 객체 목록 | 항상 | 항목이며 양식별로 나열됩니다. |
items[].form | one of 10-K, 10-Q, 20-F, 8-K, YUHO, HANKI, SHIHANKI, RINJI, 사업보고서, 반기보고서, 분기보고서 | 항상 | 항목이 속한 양식입니다. |
items[].item | 문자열 | 항상 | item이 받는 형태의 항목 번호입니다. |
items[].title | 문자열 | 항상 | 항목의 제목입니다. |
items[].part | 문자열 | 선택 | 항목이 속한 부입니다. 양식에 부가 없으면 생략합니다. |
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/filings/sections/items?form=10-K"{
"items": [
{
"form": "10-K",
"item": "1",
"title": "Business",
"part": "I"
},
{
"form": "10-K",
"item": "1A",
"title": "Risk Factors",
"part": "I"
},
{
"form": "10-K",
"item": "1B",
"title": "Unresolved Staff Comments",
"part": "I"
},
{
"form": "10-K",
"item": "1C",
"title": "Cybersecurity",
"part": "I"
}
]
}재무제표와 함께 세그먼트 조회
GET /v1/companies/{company_id}/financials
segments=true는 재무제표 응답에 segments를 더합니다. 기업이 세그먼트, 제품 또는 지역별로 나누는 매출, 영업이익, 자산, 설비투자, 감가상각, 영업권, 장기 자산입니다. segments=true가 없는 재무 응답과 같은 경로, 같은 가격입니다. 각 재무제표의 행은 공시 API 페이지에 있습니다.
segments=true가 없으면 공시 API의 재무 경로이며 응답에 segments가 없습니다. 있으면 어떤 기간이나 이후 공시가 수치를 제공할 때 segments를 보냅니다. 최신 기간이 먼저이고, 매출이 다른 지표보다 앞에 옵니다.
세그먼트는 응답에 포함된 기간을 따르므로 period, fiscal_, as_, version이 같은 방식으로 범위를 정합니다.
MCP: 도구 filings_.
매개변수
| 매개변수 | 위치 | 필수 | 유형 | 의미 |
|---|---|---|---|---|
company_ | 경로 | 예 | 문자열 | 기업 ID입니다. 예: usa:0000320193. usa:AAPL 같은 티커 별칭도 사용할 수 있습니다. |
fields | 쿼리 | 아니요 | 문자열 | 쉼표로 구분한 표준 항목 이름이거나 all입니다. 생략하면 흔히 쓰는 15개 항목입니다. |
statement | 쿼리 | 아니요 | one of income, balance, cash_flow, per_share, shares, other | 한 재무제표의 모든 항목: income, balance, cash_, per_, shares, other. |
period | 쿼리 | 아니요 | one of annual, semiannual, quarterly | 기본값은 annual이며, semiannual 또는 quarterly는 등록 기관이 공표하는 범위에서 쓸 수 있습니다. 미국 기업에는 반기 보고서가 없습니다. |
fiscal_ | 쿼리 | 아니요 | 정수 | 회계연도 하나입니다. |
basis | 쿼리 | 아니요 | one of consolidated, standalone | consolidated 또는 standalone입니다. |
version | 쿼리 | 아니요 | one of latest, first_reported | 기본값은 latest이며 first_도 쓸 수 있습니다. |
as_ | 쿼리 | 아니요 | 날짜 | 이 날짜에 알려져 있던 수치입니다(YYYY-MM-DD). |
segments | 쿼리 | 아니요 | 불리언 | true이면 segments를 더합니다. 응답에 포함된 기간에 대해 제출자가 세그먼트, 제품 또는 지역별로 나누는 매출, 영업이익, 자산, 설비투자, 감가상각, 영업권, 장기 자산입니다. 라벨은 기업 고유의 것으로 공시의 언어로 되어 있고, 각 수치에는 currency가 붙습니다. 수치는 해당 기간 자체의 보고서에 제출된 그대로(value, filing_)로 제공되며, 이후 공시가 바꾼 경우에는 그 공시와 함께 restated로 제공됩니다. version=first_는 제출 당시 수치만 반환합니다. 보고서를 세그먼트용으로 아직 읽지 않은 기간은 segments_에 이름이 올라가며, 그 행은 이후 공시에서 가져옵니다. 이 내역을 지원하지 않는 국가의 기업은 404 not_입니다. |
응답 필드
| 필드 | 유형 | 전송 | 의미 |
|---|---|---|---|
id | 문자열 | 항상 | 공시 ID입니다. 재무 응답에서는 기업 ID입니다. |
currency | 문자열 | 선택 | 재무제표 금액의 통화입니다. |
basis | one of consolidated, standalone | 선택 | consolidated 또는 standalone입니다. |
from_ | 정수 | 선택 | 응답에 포함된 첫 회계연도이며, 이력이 잘렸을 때 보냅니다. 그렇지 않으면 생략합니다. |
annual | 객체 목록 | 선택 | 연간 행이며 최신순입니다. period가 요청하면 행의 키는 semiannual 또는 quarterly입니다. 행의 항목은 공시 API 페이지에 있습니다. |
semiannual | 객체 목록 | 선택 | period=semiannual일 때의 반기 행입니다. |
quarterly | 객체 목록 | 선택 | period=quarterly일 때의 분기 행입니다. |
as_ | 날짜 | 선택 | 수치의 기준일입니다. |
segments | 객체 목록 | 선택 | 응답에 포함된 기간의 내역이며 최신 기간이 먼저입니다. 읽은 기간이 없고 이후 공시에도 수치가 없으면 생략합니다. |
segments[].end | 날짜 | 항상 | 기간의 종료일이거나 수치의 날짜입니다. |
segments[].start | 날짜 | 선택 | 기간의 시작일입니다. 자산이나 영업권처럼 특정 날짜의 수치에서는 생략합니다. |
segments[].measure | one of revenue, operating_income, assets, capex, depreciation, goodwill, long_lived_assets | 항상 | 측정 대상: revenue, operating_, assets, capex, depreciation, goodwill, long_. |
segments[].axis | one of segment, product, geography | 항상 | 기업이 나누는 방식: segment, product, geography. |
segments[].member | 문자열 | 항상 | 공시에 태그된 대로, 세그먼트, 제품 또는 지역에 대해 기업이 쓰는 이름입니다. |
segments[].label | 문자열 | 선택 | 멤버에 대해 기업이 직접 쓰는 표현입니다. |
segments[].concept | 문자열 | 항상 | 기업이 해당 수치에 사용한 태그입니다. |
segments[].value | 문자열 | 선택 | 이 기간의 보고서(filing_)에 제출된 그대로의 수치입니다. restated_ 멤버에서는 생략합니다. |
segments[].filing_ | 문자열 | 선택 | value가 제출된 공시이며, 이 기간의 첫 보고서입니다. |
segments[].currency | 문자열 | 항상 | 수치의 통화입니다. |
segments[].percent_ | 문자열 | 선택 | filing_의 공시에 있는 같은 개념, 기간, 통화의 연결 수치에 대한 값의 비율(퍼센트)이며, 소수 둘째 자리까지 0에서 먼 쪽으로 반올림합니다("37.42"). 공시 자체의 차원 없는 수치이며 멤버의 합이 아닙니다. 제출자가 소계와 연결 멤버를 더하고, 일부는 배분 전 비용을 제외한 세그먼트 이익에 연결 개념의 태그를 붙이므로 멤버의 합이 항상 100이 되는 것은 아닙니다. 값과 합계의 부호가 반대이면(흑자 기업의 적자 세그먼트) 음수이고, 연결 적자 기업의 적자 세그먼트는 양수입니다. 공시에 해당 개념과 기간의 연결 수치가 인쇄되어 있지 않거나(예: 합계가 다른 개념으로 태그됨), 합계가 0이거나, 통화가 다르면 생략합니다. |
segments[].restated | 객체 | 선택 | 이후 공시가 제시하는 수치이며, 제출 당시 수치를 바꾼 경우에 그 공시와 함께 제공합니다. restated_ 행에서는 보유한 유일한 수치이며 재작성이 아닐 수도 있습니다. |
segments[].restated.value | 문자열 | 항상 | 재작성된 수치이며 currency의 통화 단위 그대로입니다. |
segments[].restated.filing_ | 문자열 | 항상 | 재작성된 수치의 출처가 되는 이후 공시입니다. |
segments[].restated.percent_ | 문자열 | 선택 | filing_의 공시에 있는 같은 개념, 기간, 통화의 연결 수치에 대한 값의 비율(퍼센트)이며, 소수 둘째 자리까지 0에서 먼 쪽으로 반올림합니다("37.42"). 공시 자체의 차원 없는 수치이며 멤버의 합이 아닙니다. 제출자가 소계와 연결 멤버를 더하고, 일부는 배분 전 비용을 제외한 세그먼트 이익에 연결 개념의 태그를 붙이므로 멤버의 합이 항상 100이 되는 것은 아닙니다. 값과 합계의 부호가 반대이면(흑자 기업의 적자 세그먼트) 음수이고, 연결 적자 기업의 적자 세그먼트는 양수입니다. 공시에 해당 개념과 기간의 연결 수치가 인쇄되어 있지 않거나(예: 합계가 다른 개념으로 태그됨), 합계가 0이거나, 통화가 다르면 생략합니다. |
segments[].restated_ | 항상 true | 선택 | true이면 제출 당시 수치를 보유하고 있지 않다는 뜻입니다. 이 기간의 보고서에 그 멤버가 없거나(이후 공시가 기간을 다른 멤버로 다시 나눔), 보고서를 아직 불러오지 않은 경우(기간이 segments_에 있음)입니다. value와 filing_는 생략되고 restated가 유일한 수치, 즉 이후 공시의 수치이며, 두 번째 경우에는 재작성이 아닐 수도 있습니다. 보고서를 불러오면 그 행에 value와 filing_가 생깁니다. |
segments_ | list of date | 선택 | 해당 기간 자체의 보고서를 세그먼트용으로 아직 읽지 않은 기간의 종료일이며 최신순입니다. 제출 당시 수치가 없다는 것은 제출이 없었다는 뜻과 다릅니다. 이런 기간의 행이 있다면 restated_이며 이후 공시에서 가져옵니다. |
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/companies/usa:0001260221/financials?segments=true&period=annual&fiscal_year=2024&statement=income"{
"id": "usa:0001260221",
"currency": "USD",
"annual": [
{
"fy": 2024,
"end": "2024-09-30",
"form": "10-K",
"derived": [],
"revenue": "7940000000",
"gross_profit": "4672000000",
"operating_income": "3531000000",
"net_income": "1714000000"
}
],
"as_of": "2026-11-10",
"segments": [
{
"end": "2024-09-30",
"start": "2023-10-01",
"measure": "revenue",
"axis": "geography",
"member": "country:US",
"label": "UNITED STATES",
"concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",
"value": "5032000000",
"filing_id": "usa:0001260221:0001260221-24-000083",
"currency": "USD",
"percent_of_total": "63.38"
},
{
"end": "2024-09-30",
"start": "2023-10-01",
"measure": "revenue",
"axis": "segment",
"member": "tdg:PowerAndControlMember",
"label": "Power And Control [Member]",
"concept": "us-gaap:Revenues",
"value": "3941000000",
"filing_id": "usa:0001260221:0001260221-24-000083",
"currency": "USD",
"percent_of_total": "49.63",
"restated": {
"value": "3966000000",
"filing_id": "usa:0001260221:0001260221-25-000081",
"percent_of_total": "49.95"
}
},
{
"end": "2024-09-30",
"start": "2023-10-01",
"measure": "revenue",
"axis": "geography",
"member": "country:US",
"label": "UNITED STATES",
"concept": "us-gaap:Revenues",
"currency": "USD",
"restated": {
"value": "5032000000",
"filing_id": "usa:0001260221:0001260221-25-000081",
"percent_of_total": "63.38"
},
"restated_only": true
},
{
"end": "2024-09-30",
"measure": "assets",
"axis": "segment",
"member": "tdg:PowerAndControlMember",
"label": "Power And Control [Member]",
"concept": "us-gaap:Assets",
"value": "9139000000",
"filing_id": "usa:0001260221:0001260221-24-000083",
"currency": "USD",
"percent_of_total": "35.72",
"restated": {
"value": "9180000000",
"filing_id": "usa:0001260221:0001260221-25-000014",
"percent_of_total": "35.88"
}
}
]
}오류
오류는 공통 문제 형식을 사용하며, 다음 필드를 포함합니다: request_. 확인 API 오류 코드와 크레딧 형식과 크레딧 헤더에 대한 설명이 있습니다. 실패한 요청에는 요금이 부과되지 않습니다.
| 코드 | 상태 | 의미 |
|---|---|---|
invalid_ | 400 | 매개변수가 없거나, 알 수 없거나, 중복되었거나, 범위를 벗어났습니다. |
company_ | 404 | ID와 일치하는 기업이 없습니다. |
filing_ | 404 | ID와 일치하는 공시가 없거나, 기업에 그 양식과 기간의 공시가 없습니다. |
item_ | 404 | 공시에 그런 항목이 없습니다. 기업으로 조회한 8-K에서는 최근 8-K 10건 중 어느 것에도 그 항목이 없습니다. |
sections_ | 404 | 이 공시의 본문을 제공하지 않습니다. 본문을 아직 읽지 않았거나, 미국 공시가 아니거나, 항목을 구분하지 못했습니다. |
segments_ | 404 | 이 기업의 세그먼트를 아직 읽지 않았습니다. |
not_ | 404 | 해당 시장, 국가 또는 기업은 아직 제공되지 않습니다. |
insufficient_ | 402 | 크레딧 잔액이 요청 비용보다 적습니다. |
company_ | 503 | 이 경로의 근거 공시를 지금은 읽을 수 없습니다. 잠시 후 다시 시도하세요. |
이 페이지가 도움이 되었나요?