# SEC 提出書類の項目を取得

**API:** Data API

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

**Tags:** Financial Data

1 件の SEC 提出書類内にある番号付き項目の全文です。`ticker`、`filing_type`（10-K、10-Q、8-K）、`year` はすべて必須です。`quarter`、`item`、`accession_number`、`include_exhibits` でさらに絞り込めます。`items` を返し、各項目には `number`、`title`、完全な `text` が含まれます。さらに `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 の場合の提出書類の accession number。 |
| `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": "準備中の提出書類の accession number。"
    },
    "message": {
      "type": "string",
      "description": "次に行うべきことの人間が読める説明。"
    }
  }
}
```

### ResponseE40Feb4D3D6B_FilingItemsResponse

`#/components/schemas/ResponseE40Feb4D3D6B_FilingItemsResponse`

```json
{
  "type": "object",
  "properties": {
    "resource": {
      "type": "string",
      "description": "リソースタイプの識別子。"
    },
    "ticker": {
      "type": "string",
      "description": "会社の ticker シンボル。"
    },
    "cik": {
      "type": "string",
      "description": "企業の Central Index Key（CIK）。"
    },
    "filing_type": {
      "type": "string",
      "description": "提出書類の種類。"
    },
    "accession_number": {
      "type": "string",
      "description": "提出書類の accession number。"
    },
    "year": {
      "type": "integer",
      "description": "提出書類の年。"
    },
    "quarter": {
      "type": "integer",
      "description": "提出書類の四半期。"
    },
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_FilingItem"
      }
    }
  }
}
```