> ## Documentation Index
> Fetch the complete documentation index at: https://docs.case.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Search EDGAR filings and entity history

> Search SEC EDGAR full-text filings via efts.sec.gov or fetch a filer's structured filing history via data.sec.gov. Returns direct SEC archive URLs with filing metadata and match snippets when available.



## OpenAPI

````yaml /openapi.json post /legal/v1/sec-filing
openapi: 3.1.0
info:
  title: Case.dev API
  description: >-
    The AI-native platform for legal technology. Build smarter legal
    applications with our suite of AI-powered APIs.
  version: 1.0.0
  contact:
    name: Case.dev Support
    email: support@casemark.com
    url: https://case.dev
  license:
    name: Proprietary
    url: https://case.dev/terms
servers:
  - url: https://api.case.dev
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Vaults
    description: Secure document storage with semantic search and GraphRAG
  - name: Vault Events
    description: Vault-scoped event subscriptions and delivery testing
  - name: Vault Memory
    description: Vault-scoped persistent memory and semantic retrieval
  - name: Vault Objects
    description: Vault object management, content access, and document operations
  - name: Memory
    description: >-
      Persistent memory for AI agents with semantic search and 12 generic
      indexed tag fields
  - name: OCR
    description: Extract text from PDFs, images, and scanned documents
  - name: Voice
    description: Audio transcription and text-to-speech
  - name: LLMs
    description: Access 40+ language models through a unified API
  - name: Search
    description: Web search and AI answers
  - name: Mail
    description: Managed inboxes for agent email workflows
  - name: Media
    description: Transcript retrieval and captioned media clip generation
  - name: Legal
    description: Legal research tools including citation verification
  - name: Privilege
    description: Privilege detection for e-discovery and litigation workflows
  - name: Compute
    description: Serverless GPU and CPU infrastructure
  - name: Format
    description: Document formatting and template rendering (MD/JSON to PDF/DOCX)
  - name: SuperDoc
    description: Document conversion and template automation
  - name: Webhooks
    description: Webhook endpoint management
  - name: System
    description: Public system metadata and discovery endpoints
  - name: Usage
    description: Usage reporting and webhook subscriptions
  - name: Database
    description: Serverless PostgreSQL databases with instant branching
  - name: Translation
    description: Language detection and translation for multilingual legal workflows
  - name: Skills
    description: Search and read legal AI skills for agents
  - name: Agents/Linc
    description: Durable, stateful legal agent sessions with sandboxed tools and files
  - name: Matters
    description: Matter-native legal workspaces and orchestration primitives
  - name: Connectors
    description: Import and export between provider folders (Google Drive) and vaults
  - name: Applications Projects
    description: Web application project management
  - name: Applications Deployments
    description: Web application deployment management
  - name: Applications Domains
    description: Custom domain configuration for applications
  - name: Applications Env Vars
    description: Environment variable management for applications
paths:
  /legal/v1/sec-filing:
    post:
      tags:
        - Legal
      summary: Search EDGAR filings and entity history
      description: >-
        Search SEC EDGAR full-text filings via efts.sec.gov or fetch a filer's
        structured filing history via data.sec.gov. Returns direct SEC archive
        URLs with filing metadata and match snippets when available.
      operationId: legalSecFiling
      requestBody:
        description: SEC filing search or entity lookup parameters
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - type
              properties:
                type:
                  type: string
                  enum:
                    - search
                    - entity
                  description: >-
                    Run a full-text search or fetch a single entity filing
                    history
                query:
                  type: string
                  minLength: 2
                  maxLength: 1000
                  description: 'Full-text SEC search query (required for type: search)'
                formTypes:
                  type: array
                  description: Optional SEC form type filter such as 10-K, 10-Q, 8-K, or 4
                  items:
                    type: string
                ticker:
                  type: string
                  description: >-
                    Optional company ticker. Valid for both search and entity
                    lookups.
                entity:
                  type: string
                  description: >-
                    Optional entity filter passed through to EDGAR full-text
                    search
                cik:
                  type: string
                  description: CIK for entity lookups. Accepts padded or unpadded digits.
                dateAfter:
                  type: string
                  format: date
                  description: Optional lower filing date bound (YYYY-MM-DD)
                dateBefore:
                  type: string
                  format: date
                  description: Optional upper filing date bound (YYYY-MM-DD)
                limit:
                  type: integer
                  minimum: 1
                  maximum: 100
                  default: 25
                  description: Maximum filings to return
                offset:
                  type: integer
                  minimum: 0
                  default: 0
                  description: Result offset for pagination
      responses:
        '200':
          description: SEC filings retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    enum:
                      - search
                      - entity
                  query:
                    type: string
                    nullable: true
                  entity:
                    type: string
                    nullable: true
                  ticker:
                    type: string
                    nullable: true
                  cik:
                    type: string
                    nullable: true
                  formTypes:
                    type: array
                    items:
                      type: string
                  dateAfter:
                    type: string
                    format: date
                    nullable: true
                  dateBefore:
                    type: string
                    format: date
                    nullable: true
                  limit:
                    type: integer
                  offset:
                    type: integer
                  total:
                    type: integer
                  filings:
                    type: array
                    items:
                      type: object
                      properties:
                        accessionNumber:
                          type: string
                        formType:
                          type: string
                        filedAt:
                          type: string
                          format: date
                        periodOfReport:
                          type: string
                          format: date
                          nullable: true
                        entity:
                          type: object
                          properties:
                            name:
                              type: string
                              nullable: true
                            cik:
                              type: string
                            ticker:
                              type: string
                              nullable: true
                            sic:
                              type: string
                              nullable: true
                            sicDescription:
                              type: string
                              nullable: true
                            stateOfIncorporation:
                              type: string
                              nullable: true
                            entityType:
                              type: string
                              nullable: true
                        description:
                          type: string
                          nullable: true
                        documents:
                          type: array
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                              description:
                                type: string
                              url:
                                type: string
                        snippet:
                          type: string
                          nullable: true
                        secUrl:
                          type: string
        '400':
          description: Bad request - invalid SEC filing parameters
        '401':
          description: Unauthorized - invalid API key
        '403':
          description: Forbidden - insufficient permissions
        '404':
          description: Ticker or SEC entity not found
        '503':
          description: Service unavailable - SEC upstream unavailable or throttled
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key starting with `sk_case_`

````