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

Get SEC filings

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 filings

​

The SEC filing index for one company — a list of filings, not their contents. Each entry carries cik, accession_number, filing_type, report_date, filing_date, ticker and url. Accepts ticker or cik, narrows by filing_type, and caps with limit. Use it to find which filing you want and to get its accession_number. To read the text inside one, use get_financial_filings_items.

Query Parameters
  • cik
    Type: string

    The Central Index Key (CIK) of the company.

  • ticker
    Type: string

    The ticker symbol.

  • filing_type
    Type: array string[] enum

    Filter by one or more filing types. Repeat the query parameter to pass multiple values (e.g. filing_type=10-Q&filing_type=10-K).

    values
    • 10-K
    • 10-Q
    • 8-K
    • 20-F
    • 6-K
  • limit
    Type: integer
    min:  
    1

    The maximum number of filings to return (default: 10).

Responses
  • 200
    Type: object · FilingsResponse

    SEC filings response

    • filings
      Type: array object[] · Filing[]
      • accession_number
        Type: string

        The accession number of the filing.

      • cik
        Type: integer

        The Central Index Key (CIK) of the company.

      • filing_type
        Type: string

        The type of the SEC filing (e.g., 10-Q, 8-K).

      • report_date
        Type: string Format: date

        The date of the report.

      • ticker
        Type: string

        The ticker symbol.

      • url
        Type: string Format: uri

        The URL of the SEC 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
curl https://openapi.felo.ai/v1/beta/financial/filings \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "filings": [
    {
      "cik": 1,
      "accession_number": "string",
      "filing_type": "string",
      "report_date": "2026-09-30",
      "ticker": "string",
      "url": "https://example.com"
    }
  ]
}

SEC filings response

Get SEC filings