Filing Evidence

Plan and retrieve citation-ready filing evidence for qualitative SEC questions.

Tier: paid | Cache: llm-call | Playground: authenticated only | Contract: 1.0.0

When To Use It

Use these tools to discover filings, inspect filing artifacts, and retrieve source-backed document evidence.

Request Examples


BASE_URL="${EDGAR_API_URL:-https://www.edgarparser.com}"
 
curl -sS "$BASE_URL/api/filing/evidence" \
  -X POST \
  -H "Authorization: Bearer $EDGAR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"quarter":4,"query":"revenue recognition","source":"auto","ticker":"AAPL","year":2025}'


import os
import requests
 
base_url = os.getenv("EDGAR_API_URL", "https://www.edgarparser.com")
headers = {"Authorization": f"Bearer {os.environ['EDGAR_API_KEY']}"}
payload = {
  "quarter": 4,
  "query": "revenue recognition",
  "source": "auto",
  "ticker": "AAPL",
  "year": 2025
}
 
response = requests.post(f"{base_url}/api/filing/evidence", headers=headers, json=payload, timeout=30)
response.raise_for_status()
data = response.json()

Response Fields To Inspect

accession, filing_url, form type, and period fields to confirm the filing identity.
Pagination or truncation fields before assuming the returned text is complete.
Section titles and document names when citing prose back to the filing.

Errors And Coverage

401 or 403: the API key is missing, expired, or not allowed to use this tier.
429: retry after the rate-limit window, and prefer broader batch or series tools over repeated single-period calls.
Paid or LLM-backed paths should be used only when cheaper fact, filing, table, or text tools cannot answer the question.
Honor pagination and truncation metadata; request the next page instead of assuming the first response is complete.

Filing Document, Search Filing Text, Cite Concept

Generated Reference

Contract

Field	Value
Tool	`get_filing_evidence`
Method	`POST`
Path	`/api/filing/evidence`
Contract version	`1.0.0`
Schema fingerprint	`sha256:0adfe931989f0028e561fc2d2ebc7d374034fc1528d195903eaeca8973f3d859`

Parameters

Name	Location	Required	Type	Notes
none	-	-	-	-

Request Body Schema


{
  "additionalProperties": false,
  "properties": {
    "filing_date_from": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "filing_date_to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "form_types": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "include_full_sections": {
      "default": false,
      "type": "boolean"
    },
    "include_planner_trace": {
      "default": false,
      "type": "boolean"
    },
    "max_hits": {
      "default": 12,
      "maximum": 100.0,
      "minimum": 1.0,
      "type": "integer"
    },
    "quarter": {
      "type": "integer"
    },
    "query": {
      "type": "string"
    },
    "related_tickers": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "source": {
      "default": "auto",
      "type": "string"
    },
    "task_intent": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "ticker": {
      "type": "string"
    },
    "year": {
      "type": "integer"
    }
  },
  "required": [
    "ticker",
    "year",
    "quarter",
    "query"
  ],
  "type": "object"
}

Response Schema (200)

{}