# Получение пунктов документа 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`. Возвращает `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 | Номер документа (accession number), если это 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 — Требуется действительный API-ключ Felo.

### 402 — Запрос не может быть выполнен: не выполнено требование биллинга.

### 403 — Аккаунту не разрешено выполнять эту операцию.

### 429 — Достигнут лимит запросов или расходов.

### 502 — Сервис не смог выполнить запрос.

### 503 — API или сервис биллинга временно недоступны.

### 504 — Истекло время ожидания обработки запроса.

### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

**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": "URL документа приложения на сайте SEC."
    },
    "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": "Всегда 'processing' при ответе 202."
    },
    "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": "Central Index Key (CIK) компании."
    },
    "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"
      }
    }
  }
}
```