algoum-de

algoum-de Common API

Ticker/CIK resolution and company search, the raw SEC filing behind every record, and the freshness of each data source.

Documentation GitHub OpenAPI

Operations 3

GET /tickers Ticker⇄CIK resolution / company search #

GET /filings/{id} Get a raw SEC filing #

GET /status Data freshness per source #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/algoum-de:algoum-de-common-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Algoum De Common API
  version: 1.0.0
  license:
    name: Proprietary
    identifier: LicenseRef-Proprietary
  description: 'Operations tagged common across 3 of this provider''s published API definitions: algoum-de-api-openapi.json, algoum-de-site-openapi.json, algoum-de-site-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.algoum.de/v1
  name: production
  description: Production environment.
security:
- bearerAuth: []
tags:
- name: Common
  summary: Shared helper endpoints
  description: 'Ticker/CIK resolution and company search, the raw SEC filing behind every

    record, and the freshness of each data source.'
paths:
  /tickers:
    get:
      tags:
      - Common
      operationId: resolveTickers
      summary: Ticker⇄CIK resolution / company search
      description: 'Resolves a ticker or a CIK, or searches companies by free text.

        Fixed sort order for the free-text search: best name match first.


        Either `query`, `ticker` or `cik` is required; a request without any of

        them is answered with `400`.'
      parameters:
      - name: query
        in: query
        description: Free-text company search.
        schema:
          type: string
      - $ref: '#/components/parameters/Ticker'
      - $ref: '#/components/parameters/Cik'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Cursor'
      responses:
        '200':
          description: Matching tickers/companies.
          content:
            application/json:
              examples:
                default:
                  $ref: '#/components/examples/TickerList'
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/TickerEntry'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
    servers:
    - url: https://api.algoum.de/v1
      name: production
      description: Production environment.
  /filings/{id}:
    get:
      tags:
      - Common
      operationId: getFiling
      summary: Get a raw SEC filing
      description: Metadata and source URL of the originating filing behind all modules.
      parameters:
      - $ref: '#/components/parameters/PathId'
      responses:
        '200':
          description: Filing metadata.
          content:
            application/json:
              examples:
                default:
                  $ref: '#/components/examples/FilingItem'
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    data:
                      $ref: '#/components/schemas/Filing'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
    servers:
    - url: https://api.algoum.de/v1
      name: production
      description: Production environment.
  /status:
    get:
      tags:
      - Common
      operationId: getStatus
      summary: Data freshness per source
      description: 'Data freshness and last successful import per source.

        Fixed sort order: form type ascending.'
      responses:
        '200':
          description: Current import status.
          content:
            application/json:
              examples:
                default:
                  $ref: '#/components/examples/StatusList'
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    data:
                      type: array
                      items:
                        $ref: '#/components/schemas/SourceStatus'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
    servers:
    - url: https://api.algoum.de/v1
      name: production
      description: Production environment.
components:
  parameters:
    PathId:
      name: id
      in: path
      required: true
      description: Resource ID.
      schema:
        type: string
    Ticker:
      name: ticker
      in: query
      description: Stock ticker (preferred instrument filter), e.g. `AAPL`.
      schema:
        type: string
        example: AAPL
    Limit:
      name: limit
      in: query
      description: Maximum number of results.
      schema:
        type: integer
        minimum: 1
        maximum: 500
        default: 50
    Cursor:
      name: cursor
      in: query
      description: Opaque cursor for the next page.
      schema:
        type: string
    Cik:
      name: cik
      in: query
      description: 'Central Index Key (alternative to the ticker). Leading zeros are optional: `0000320193` and `320193` return the same rows. In responses the key is always ten digits, so it is safe to use as a join key.'
      schema:
        type: string
        example: 0000320193
  schemas:
    Envelope:
      type: object
      description: Uniform response envelope. `data` is specialised per endpoint.
      required:
      - meta
      properties:
        meta:
          $ref: '#/components/schemas/Meta'
    Filing:
      type: object
      required:
      - filing_id
      - form_type
      - cik
      - filed_at
      - source_url
      properties:
        filing_id:
          type: string
          description: Accession number of the filing. All modules return it without a prefix; `/filings/{id}` additionally accepts the spelling with `fil_`.
          example: 0000320193-26-000073
        accession_number:
          type: string
          example: 0000320193-26-000073
        form_type:
          type: string
          example: '4'
        cik:
          type: string
          example: 0000320193
        filed_at:
          type: string
          format: date-time
        source_url:
          type: string
          format: uri
    Meta:
      type: object
      description: Uniform metadata present in every response.
      required:
      - request_id
      - source
      properties:
        request_id:
          type: string
          example: req_01H...
        source:
          type: string
          example: sec_edgar
        data_freshness:
          type: string
          format: date-time
          description: Filing time of the most recently processed filing. Absent as long as no data has been imported – no freshness is claimed in that case.
          example: '2026-07-13T21:05:00-04:00'
        next_cursor:
          type:
          - string
          - 'null'
          description: Cursor for the next page; `null` at the end.
        warnings:
          type: array
          items:
            type: string
    ErrorResponse:
      type: object
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          - request_id
          properties:
            code:
              type: string
              example: invalid_parameter
            message:
              type: string
              example: Parameter 'ticker' or 'cik' is required.
            request_id:
              type: string
              example: req_01H...
    TickerEntry:
      type: object
      required:
      - ticker
      - cik
      - name
      properties:
        ticker:
          type: string
          example: AAPL
        cik:
          type: string
          example: 0000320193
        name:
          type: string
          example: Apple Inc.
    SourceStatus:
      type: object
      required:
      - source
      - last_import_at
      properties:
        source:
          type: string
          example: sec_edgar
        form_type:
          type: string
          example: '4'
        last_import_at:
          type: string
          format: date-time
        filings:
          type: integer
          description: Number of stored filings of this form type.
        healthy:
          type: boolean
          description: 'Freshness measured against the filing rhythm: Form 4/5 and 8-K appear daily (threshold 7 days), 13F only quarterly with a deadline of up to 45 days (threshold 120 days).'
  responses:
    ServiceUnavailable:
      description: 'A prerequisite of the endpoint is not ready: the ticker universe is still loading, or the event stream is not running. Temporary – retrying later is worthwhile.'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    TooManyRequests:
      description: Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no `request_id`. Slow down and retry.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: Resource not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    BadRequest:
      description: Invalid request parameters.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: Unexpected server-side error, error code `internal_error`. The message is always the same; the cause stays in the server log, keyed by the `request_id` that the response repeats. Quote it in a support request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  examples:
    FilingItem:
      summary: The raw filing behind a record
      value:
        meta:
          request_id: req_01K4W8AV2Q1B
          source: sec_edgar
          data_freshness: '2026-07-13T21:05:00-04:00'
          next_cursor: null
          warnings: []
        data:
          filing_id: 0000320193-26-000073
          accession_number: 0000320193-26-000073
          form_type: '4'
          cik: 0000320193
          filed_at: '2026-07-11T21:03:00-04:00'
          source_url: https://www.sec.gov/Archives/edgar/data/320193/000032019326000073/0000320193-26-000073-index.htm
    StatusList:
      summary: Freshness per source
      value:
        meta:
          request_id: req_01K4W8B27S3C
          source: sec_edgar
          data_freshness: '2026-07-15T13:42:00-04:00'
          next_cursor: null
          warnings: []
        data:
        - source: sec_edgar
          form_type: '4'
          last_import_at: '2026-07-15T13:58:00-04:00'
          filings: 412873
          healthy: true
        - source: sec_edgar
          form_type: 8-K
          last_import_at: '2026-07-15T13:59:00-04:00'
          filings: 98211
          healthy: true
        - source: sec_edgar
          form_type: 13F-HR
          last_import_at: '2026-05-16T02:10:00-04:00'
          filings: 7421
          healthy: true
    TickerList:
      summary: Resolution of one ticker
      value:
        meta:
          request_id: req_01K4W89S7N8A
          source: sec_edgar
          next_cursor: null
          warnings: []
        data:
        - ticker: AAPL
          cik: 0000320193
          name: Apple Inc.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Your own API key as a bearer token (`Authorization: Bearer <key>`).'
externalDocs:
  description: Guides – getting started, conventions, streaming.
  url: https://www.algoum.de/docs
x-refined-from:
- algoum-de-api-openapi.json
- algoum-de-site-openapi.json
- algoum-de-site-openapi.yaml