# SEC 공시 항목 조회

**API:** Data API

**Endpoint:** `GET /v1/beta/financial/filings/items`

**Tags:** Financial Data

하나의 SEC 공시 내 번호가 매겨진 항목의 전체 텍스트입니다. `ticker`, `filing_type`(10-K, 10-Q, 8-K), `year`는 모두 필수이며 `quarter`, `item`, `accession_number`, `include_exhibits`로 더 좁힐 수 있습니다. `number`, `title`, 전체 `text`가 담긴 `items`와 `filing_url`, `accession_number`를 반환합니다. 크기에 유의하세요. 10-K는 전체 산문 약 19개 항목으로 반환되므로 문서 전체가 정말 필요하지 않다면 특정 `item`을 요청하세요. 먼저 어떤 공시를 열지 찾으려면 `get_financial_filings`를 사용하세요.

### 가격 참고

- 과금 기준: 성공한 요청당 고정 원가 기준.
- 참고 요청 추정치: USD 0.02.
- 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.

참고용 메타데이터일 뿐이며, 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `accession_number` | query | no | string | 8-K인 경우 공시의 접수 번호입니다. |
| `filing_type` | query | yes | string, enum: "10-K", "10-Q", "8-K" | 공시 유형입니다. |
| `include_exhibits` | query | no | boolean, default: false | 연결된 첨부 자료의 원본 텍스트를 포함할지 여부입니다. 8-K 공시에만 적용됩니다. true이면 첨부 객체에 전체 첨부 내용이 담긴 'text' 필드가 포함됩니다. |
| `item` | query | no | string, enum: "Item-1", "Item-1A", "Item-1B", "Item-2", "Item-3", "Item-4", … | 가져올 항목입니다. |
| `quarter` | query | no | integer | 10-Q인 경우 공시의 분기입니다. |
| `ticker` | query | yes | string | 티커 심볼입니다. |
| `year` | query | yes | integer | 공시 연도입니다. |

## Responses

### 200 — SEC 공시 항목 응답

Headers:
- `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다.

**application/json**

Schema: `ResponseE40Feb4D3D6B_FilingItemsResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_FilingItemsResponse`)

### 202 — 공시가 아직 준비 중입니다. 응답 본문의 result_url을 폴링하여 결과를 가져오세요. 이 응답에는 요금이 청구되지 않습니다.

Headers:
- `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다.

**application/json**

Schema: `ResponseE40Feb4D3D6B_FilingItemsAccepted` (`#/components/schemas/ResponseE40Feb4D3D6B_FilingItemsAccepted`)

### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.

### 401 — 유효한 Felo API 키가 필요합니다.

### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.

### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다.

### 429 — 요청 또는 지출 한도에 도달했습니다.

### 502 — 서비스가 요청을 완료할 수 없습니다.

### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.

### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다.

### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseE40Feb4D3D6B_Exhibit

`#/components/schemas/ResponseE40Feb4D3D6B_Exhibit`

```json
{
  "type": "object",
  "properties": {
    "number": {
      "type": "string",
      "description": "첨부 자료 번호(예: '99.1')입니다."
    },
    "description": {
      "type": "string",
      "description": "첨부 자료의 설명입니다."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "SEC 웹사이트의 첨부 자료 문서 URL입니다."
    },
    "text": {
      "type": "string",
      "description": "첨부 자료의 원본 텍스트 내용입니다. 'include_exhibits' 매개변수가 true로 설정된 경우에만 포함됩니다."
    }
  }
}
```

### ResponseE40Feb4D3D6B_FilingItem

`#/components/schemas/ResponseE40Feb4D3D6B_FilingItem`

```json
{
  "type": "object",
  "properties": {
    "number": {
      "type": "string",
      "description": "항목 번호입니다."
    },
    "name": {
      "type": "string",
      "description": "항목 이름입니다."
    },
    "text": {
      "type": "string",
      "description": "항목 텍스트입니다."
    },
    "exhibits": {
      "type": "array",
      "description": "이 항목에 연결된 첨부 자료 배열입니다. 첨부 자료가 있는 8-K 공시에만 표시됩니다.",
      "items": {
        "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_Exhibit"
      }
    }
  }
}
```

### ResponseE40Feb4D3D6B_FilingItemsAccepted

`#/components/schemas/ResponseE40Feb4D3D6B_FilingItemsAccepted`

```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "processing"
      ],
      "description": "202 응답에서는 항상 'processing'입니다."
    },
    "request_id": {
      "type": "string",
      "format": "uuid",
      "description": "이 요청의 식별자이며 지원팀에 문의할 때 유용합니다."
    },
    "result_url": {
      "type": "string",
      "description": "결과를 폴링할 URL입니다."
    },
    "estimated_ready_at": {
      "type": "string",
      "format": "date-time",
      "description": "공시가 준비될 예상 시점입니다."
    },
    "accession_number": {
      "type": "string",
      "description": "준비 중인 공시의 접수 번호입니다."
    },
    "message": {
      "type": "string",
      "description": "다음에 수행할 작업에 대한 사람이 읽을 수 있는 설명입니다."
    }
  }
}
```

### ResponseE40Feb4D3D6B_FilingItemsResponse

`#/components/schemas/ResponseE40Feb4D3D6B_FilingItemsResponse`

```json
{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "description": "리소스 유형 식별자입니다."
    },
    "ticker": {
      "type": "string",
      "description": "회사의 티커 심볼입니다."
    },
    "cik": {
      "type": "string",
      "description": "회사의 CIK(Central Index Key)입니다."
    },
    "filing_type": {
      "type": "string",
      "description": "공시 유형입니다."
    },
    "accession_number": {
      "type": "string",
      "description": "공시의 접수 번호입니다."
    },
    "year": {
      "type": "integer",
      "description": "공시 연도입니다."
    },
    "quarter": {
      "type": "integer",
      "description": "공시의 분기입니다."
    },
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_FilingItem"
      }
    }
  }
}
```