MetricDuck Filings API

The Filings API from MetricDuck — 1 operation(s) for filings.

GitHub OpenAPI

Operations 1

GET /api/v1/filings/recent Recent filings across all tracked companies #

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/metricduck-com:metricduck-com-filings-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

metricduck-com-filings-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Metric Duck Filings API
  description: 'SEC filing data API: equity fundamentals updated daily from SEC EDGAR'
  version: 2.0.0
tags:
- name: Filings
paths:
  /api/v1/filings/recent:
    get:
      tags:
      - Filings
      summary: Recent filings across all tracked companies
      description: 'Single-call discovery for filings landed since a timestamp, optionally filtered by form type, 8-K sub-type, or portfolio tickers. Newest filing date first. A page holds at most `limit` rows: the `X-Has-More` response header is `1` when more filings match, and `X-Next-Offset` then gives the `offset` of the next page (absent past offset 1000: narrow the query instead). Backs the mcp-worker `list_recent_filings` tool — used by Routines and any agent doing event-driven portfolio monitoring.'
      operationId: list_recent_filings_api_v1_filings_recent_get
      parameters:
      - name: since
        in: query
        required: true
        schema:
          type: string
          format: date
          description: Filing date floor (inclusive). YYYY-MM-DD.
          title: Since
        description: Filing date floor (inclusive). YYYY-MM-DD.
      - name: form_types
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
          - type: 'null'
          description: Filter by SEC form type. Repeat the param for multiple values, e.g., ?form_types=8-K&form_types=10-Q.
          title: Form Types
        description: Filter by SEC form type. Repeat the param for multiple values, e.g., ?form_types=8-K&form_types=10-Q.
      - name: form_subtypes
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
          - type: 'null'
          description: 'Filter by 8-K sub-type. Allowed: ''8-K-earnings'', ''8-K-transcript'', ''8-K-event'', ''8-K-other''. Other values are silently ignored.'
          title: Form Subtypes
        description: 'Filter by 8-K sub-type. Allowed: ''8-K-earnings'', ''8-K-transcript'', ''8-K-event'', ''8-K-other''. Other values are silently ignored.'
      - name: tickers
        in: query
        required: false
        schema:
          anyOf:
          - type: array
            items:
              type: string
          - type: 'null'
          description: Optional portfolio filter; max 50 tickers.
          title: Tickers
        description: Optional portfolio filter; max 50 tickers.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Max rows (default 50, max 100).
          default: 50
          title: Limit
        description: Max rows (default 50, max 100).
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          maximum: 1000
          minimum: 0
          description: 'Rows to skip, for the next page (max 1000). Use the previous page''s `X-Next-Offset` header. Pages share one deterministic order, but each page is read (and cached for up to 30 minutes) on its own, so a filing that lands between calls can shift rows across pages: dedupe by accession, and for a complete sweep narrow the query until `X-Has-More` is 0.'
          default: 0
          title: Offset
        description: 'Rows to skip, for the next page (max 1000). Use the previous page''s `X-Next-Offset` header. Pages share one deterministic order, but each page is read (and cached for up to 30 minutes) on its own, so a filing that lands between calls can shift rows across pages: dedupe by accession, and for a complete sweep narrow the query until `X-Has-More` is 0.'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/RecentFilingItem'
                title: Response List Recent Filings Api V1 Filings Recent Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    RecentFilingItem:
      properties:
        ticker:
          type: string
          title: Ticker
        cik:
          type: string
          title: Cik
        accession_number:
          type: string
          title: Accession Number
        filed_at:
          type: string
          format: date
          title: Filed At
          description: Filing date (YYYY-MM-DD)
        form_type:
          type: string
          title: Form Type
        form_subtype:
          anyOf:
          - type: string
          - type: 'null'
          title: Form Subtype
          description: '8-K sub-type derived from section inventory: ''8-K-earnings'', ''8-K-transcript'', ''8-K-event'', ''8-K-other''. Null for non-8-K forms.'
      type: object
      required:
      - ticker
      - cik
      - accession_number
      - filed_at
      - form_type
      title: RecentFilingItem
      description: One row in the recent-filings discovery response.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key