Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Get SEC filing items

Felo API Support
MIT
Server:https://openapi.felo.ai
Client Libraries
Shell Curl

Financial Data

​

Company fundamentals, financial statements, market prices and economic data.

Financial Data Operations

Get SEC filing items

​

The full text of the numbered items inside one SEC filing. ticker, filing_type (10-K, 10-Q or 8-K) and year are all required; narrow further with quarter, item, accession_number or include_exhibits. Returns items — each with number, title and the complete text — plus filing_url and accession_number. Mind the size: a 10-K comes back as roughly 19 items of full prose, so request a specific item rather than pulling everything unless you truly need the whole document. To find which filing to open in the first place, use get_financial_filings.

Query Parameters
  • ticker
    Type: string
    required

    The ticker symbol.

  • filing_type
    Type: string enum
    required

    The type of filing.

    values
    • 10-K
    • 10-Q
    • 8-K
  • year
    Type: integer
    required

    The year of the filing.

  • quarter
    Type: integer

    The quarter of the filing if 10-Q.

  • item
    Type: string enum

    The item to get.

    values
    • Item-1
    • Item-1A
    • Item-1B
    • Item-2
    • Item-3
  • accession_number
    Type: string

    The accession number of the filing if 8-K.

  • include_exhibits
    Type: boolean

    Whether to include the raw text from linked exhibits. Only applicable for 8-K filings. When true, exhibit objects will include the 'text' field containing the full exhibit content.

Responses
  • 200
    Type: object · FilingItemsResponse

    SEC filing items response

    • accession_number
      Type: string

      The accession number of the filing.

    • cik
      Type: string

      The Central Index Key (CIK) of the company.

    • filing_type
      Type: string

      The type of filing.

    • items
      Type: array object[] · FilingItem[]
      • name
        Type: string

        The item name.

      • number
        Type: string

        The item number.

      • text
        Type: string

        The item text.

    • quarter
      Type: integer

      The quarter of the filing.

    • ticker
      Type: string

      The ticker symbol of the company.

    • year
      Type: integer

      The year of the filing.

    application/json
  • 400
    Type: object · ErrorResponse

    Bad request

    • error
      Type: string

      A short error message.

    • message
      Type: string

      A more detailed error message.

    application/json
  • 401
    Type: object · ErrorResponse

    Unauthorized

    • error
      Type: string

      A short error message.

    • message
      Type: string

      A more detailed error message.

    application/json
  • 402
    Type: object · ErrorResponse

    The request requires a paid subscription

    • error
      Type: string

      A short error message.

    • message
      Type: string

      A more detailed error message.

    application/json
  • 403

    The account is not permitted to perform this operation.

  • 404
    Type: object · ErrorResponse

    The specified resource was not found

    • error
      Type: string

      A short error message.

    • message
      Type: string

      A more detailed error message.

    application/json
  • 429

    A request or spending limit has been reached.

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for get/v1/beta/financial/filings/items
curl 'https://openapi.felo.ai/v1/beta/financial/filings/items?ticker=&filing_type=10-K&year=1' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "ticker": "string",
  "cik": "string",
  "filing_type": "string",
  "accession_number": "string",
  "year": 1,
  "quarter": 1,
  "items": [
    {
      "number": "string",
      "name": "string",
      "text": "string"
    }
  ]
}

SEC filing items response

Get SEC filing items