Felo API PlatformFelo API Platform
Alle endpoints van Financial Data
v0.2.0-beta
OpenAPI 3.1.0

SEC-indieningsitems ophalen

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

Financial Data

​

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

Financial Data Operaties

SEC-indieningsitems ophalen

​

De volledige tekst van de genummerde items in één SEC-indiening. ticker, filing_type (10-K, 10-Q of 8-K) en year zijn alle vereist; verfijn verder met quarter, item, accession_number of include_exhibits. Retourneert items — elk met number, title en de volledige text — plus filing_url en accession_number. Let op de omvang: een 10-K komt terug als ruwweg 19 items volledige proza, dus vraag een specifiek item op in plaats van alles op te halen, tenzij je echt het hele document nodig hebt. Om eerst te bepalen welke indiening je moet openen, gebruik je get_financial_filings.

Prijsreferentie

  • Metering: Vaste kostenbasis per geslaagd verzoek.
  • Referentieschatting per verzoek: USD 0.02.
  • Referentieklantvermenigvuldiger: 1.0. Pas deze niet opnieuw toe op een afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Queryparameters
  • accession_number
    Type: string

    Het accessionnummer van de indiening als het een 8-K betreft.

  • filing_type
    Type: string enum
    verplicht

    Het type indiening.

    waarden
    • 10-K
    • 10-Q
    • 8-K
  • include_exhibits
    Type: boolean

    Of de ruwe tekst uit gekoppelde bijlagen moet worden opgenomen. Alleen van toepassing op 8-K-indieningen. Indien true, bevatten bijlageobjecten het veld 'text' met de volledige inhoud van de bijlage.

  • item
    Type: string enum

    Het op te halen item.

    waarden
    • Item-1
    • Item-1A
    • Item-1B
    • Item-2
    • Item-3
  • quarter
    Type: integer

    Het kwartaal van de indiening als het een 10-Q betreft.

  • ticker
    Type: string
    verplicht

    Het tickersymbool.

  • year
    Type: integer
    verplicht

    Het jaar van de indiening.

Responsen
  • 200
    Type: object · ResponseE40Feb4D3D6B_FilingItemsResponse

    SEC-indieningsitemsrespons

    • accession_number
      Type: string

      Het toegangsnummer van de inzending.

    • cik
      Type: string

      De Central Index Key (CIK) van het bedrijf.

    • filing_type
      Type: string

      Het type indiening.

    • items
      Type: array object[] · ResponseE40Feb4D3D6B_FilingItem[]
      • exhibits
        Type: array object[] · ResponseE40Feb4D3D6B_Exhibit[]

        Een array van exhibits die aan dit item zijn gekoppeld. Alleen aanwezig bij 8-K-inzendingen wanneer er exhibits zijn.

        • description
          Type: string

          De beschrijving van het exhibit.

        • number
          Type: string

          Het exhibitnummer (bijv. '99.1').

        • text
          Type: string

          De ruwe tekstinhoud van het exhibit. Alleen opgenomen wanneer de parameter 'include_exhibits' op true staat.

        • url
          Type: string Formaat: uri

          De URL naar het exhibitdocument op de SEC-website.

      • name
        Type: string

        De naam van het item.

      • number
        Type: string

        Het nummer van het item.

      • text
        Type: string

        De tekst van het item.

    • quarter
      Type: integer

      Het kwartaal van de inzending.

    • resource
      Type: string

      De identificatie van het resourcetype.

    • ticker
      Type: string

      Het tickersymbool van het bedrijf.

    • year
      Type: integer

      Het jaar van de indiening.

    application/json
  • 202
    Type: object · ResponseE40Feb4D3D6B_FilingItemsAccepted

    De indiening wordt nog voorbereid. Poll de result_url uit de responsebody om het resultaat op te halen. Voor deze respons worden geen kosten in rekening gebracht.

    • accession_number
      Type: string

      Het toegangsnummer van de inzending die wordt voorbereid.

    • estimated_ready_at
      Type: string Formaat: date-time

      Wanneer de inzending naar verwachting gereed is.

    • message
      Type: string

      Mensleesbare beschrijving van de volgende stappen.

    • request_id
      Type: string Formaat: uuid

      Identificatie voor deze aanvraag; handig bij contact met support.

    • result_url
      Type: string

      De URL om het resultaat op te vragen.

    • status
      enum
      constante:  
      processing

      Altijd 'processing' bij een 202-respons.

      waarden
      • processing
    application/json
  • 400

    Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.

  • 401

    Een geldige Felo-API-sleutel is vereist.

  • 402

    Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.

  • 403

    Het account mag deze bewerking niet uitvoeren.

  • 429

    Een verzoek- of bestedingslimiet is bereikt.

  • 502

    De dienst kon het verzoek niet voltooien.

  • 503

    De API of factureringsdienst is tijdelijk niet beschikbaar.

  • 504

    Er is een time-out opgetreden bij het verwerken van het verzoek.

  • default

    Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

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

{
  "resource": "string",
  "ticker": "string",
  "cik": "string",
  "filing_type": "string",
  "accession_number": "string",
  "year": 1,
  "quarter": 1,
  "items": [
    {
      "number": "string",
      "name": "string",
      "text": "string",
      "exhibits": [
        {
          "number": "string",
          "description": "string",
          "url": "https://example.com",
          "text": "string"
        }
      ]
    }
  ]
}

SEC-indieningsitemsrespons

Get SEC filing items