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. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: AgentFilings Health API
version: 1.0.0
description: 'Structured US SEC/EDGAR filing data for autonomous agents: filings index, XBRL-derived earnings summaries, and Form 4 insider transactions as clean JSON. Public-domain SEC data, pre-parsed and normalized. Paid endpoints use x402 (USDC on Base); /health and /probe are free. Call /probe first to check coverage and pricing before paying.'
contact:
email: ekrishtul@yahoo.com
license:
name: 'Data: US SEC EDGAR (public domain)'
x-guidance: 'Call GET /probe?ticker=SYMBOL first — it is free and tells you whether the ticker is covered, how much data exists, how fresh it is, and the exact price of each endpoint. If ticker_coverage.covered is false, do not pay: paid endpoints will return 404. Paid endpoints answer HTTP 402 with payment requirements in the base64 PAYMENT-REQUIRED header (x402 v2, USDC on Base mainnet); pay and retry the identical request. Every response is { data, meta }, and meta carries the SEC source accession and timestamps so figures can be traced back to the original filing. Coverage is US public companies filing with SEC EDGAR and is still expanding — call /probe for the authoritative answer on any specific ticker rather than assuming an index.'
servers:
- url: https://api.agentfilings.com
tags:
- name: Health
paths:
/health:
get:
operationId: health
summary: Liveness probe
security: []
responses:
'200':
description: 'Success. Envelope: { data, meta } where meta carries source and freshness.'
content:
application/json:
schema:
$ref: '#/components/schemas/Envelope'
tags:
- Health
components:
schemas:
Envelope:
type: object
required:
- data
- meta
properties:
data:
description: Endpoint-specific payload.
meta:
type: object
required:
- retrieved_at
- cache
properties:
source_api:
type: string
source_accession:
type: string
filed_at:
type:
- string
- 'null'
retrieved_at:
type: string
format: date-time
cache:
type: string
enum:
- hit
- miss