Filing Clarity API

Programmatic access to your filing intelligence data. Available on Intelligence and Portfolio plans.

Authentication

All API requests require a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Get your API key from your account settings at getfilingclarity.com/account.

API keys are prefixed with fc_live_. Keep your key secret — it carries your full plan permissions.

Base URL

https://getfilingclarity.com/api

All responses are JSON. Dates are ISO 8601 (UTC). Monetary values are in USD cents unless noted.

Endpoints

GET /api/filings Pro · Elite

Returns processed filings for a ticker on your watchlist, with AI-extracted structured data.

Parameters

Name	Type	Required	Description
ticker	string	required	Ticker symbol, e.g. `AAPL`
type	string	optional	Filter by filing type: `8k`, `10q`, `form4`, `13f`
limit	integer	optional	Number of results. Default: 10, max: 50

Example Request

curl -H "Authorization: Bearer fc_live_xxxx" \
  "https://getfilingclarity.com/api/filings?ticker=AAPL&limit=5"

Example Response

{
  "ticker": "AAPL",
  "company": "Apple Inc.",
  "filings": [
    {
      "filing_type": "10-Q",
      "filed_at": "2026-05-02",
      "period_of_report": "2026-03-31",
      "extracted_data": {
        "revenue_current": 95400000000,
        "revenue_prior": 90400000000,
        "net_income_current": 24100000000,
        "eps_diluted_current": 1.53,
        "going_concern": false
      },
      "edgar_url": "https://www.sec.gov/Archives/edgar/data/320193/..."
    }
  ],
  "retrieved_at": "2026-07-15T14:32:00Z"
}

GET /api/insider Pro · Elite

Returns Form 4 insider transactions for a ticker on your watchlist.

Parameters

Name	Type	Required	Description
ticker	string	required	Ticker symbol
limit	integer	optional	Default: 10, max: 50

Example Request

curl -H "Authorization: Bearer fc_live_xxxx" \
  "https://getfilingclarity.com/api/insider?ticker=MSFT"

Example Response

{
  "ticker": "MSFT",
  "transactions": [
    {
      "insider_name": "Satya Nadella",
      "insider_title": "Chief Executive Officer",
      "transaction_date": "2026-07-10",
      "transaction_type": "OPEN_MARKET_SELL",
      "shares_transacted": 50000,
      "price_per_share": 425.50,
      "total_value": 21275000,
      "shares_owned_after": 850000,
      "is_open_market": true,
      "edgar_url": "https://www.sec.gov/..."
    }
  ]
}

GET /api/watchlist All plans

Returns your current watchlist with notes and metadata.

Parameters

No parameters required.

Example Request

curl -H "Authorization: Bearer fc_live_xxxx" \
  "https://getfilingclarity.com/api/watchlist"

Example Response

{
  "watchlist": [
    {
      "ticker": "AAPL",
      "company": "Apple Inc.",
      "cik": "0000320193",
      "added_at": "2026-07-01",
      "notes": "Core position — watching margins"
    }
  ],
  "count": 15,
  "limit": 15,
  "tier": "basic"
}

GET /api/short Elite only

Returns short interest data for a ticker on your watchlist. Updated on FINRA's bi-monthly schedule (1st and 15th of each month).

Parameters

Name	Type	Required	Description
ticker	string	required	Ticker symbol

Example Request

curl -H "Authorization: Bearer fc_live_xxxx" \
  "https://getfilingclarity.com/api/short?ticker=NVDA"

Example Response

{
  "ticker": "NVDA",
  "short_interest": [
    {
      "report_date": "2026-07-01",
      "short_interest_shares": 125000000,
      "short_interest_pct_float": 2.8,
      "days_to_cover": 1.2,
      "change_pct": -5.2
    }
  ]
}

Error Codes

Code	Meaning
200	Success
401	Invalid or missing API key
403	Feature not available on your plan
404	Ticker not in your watchlist
429	Rate limit exceeded
500	Server error

Errors return a JSON body: {"error": "message", "code": 401}

Rate Limits

Usage resets at midnight UTC daily. Each response includes a rate limit header:

X-RateLimit-Remaining: 847

Pro — $65/mo

1,000 requests/day
All endpoints except /api/short

Elite — $150/mo

5,000 requests/day
All endpoints including short interest

Code Examples

Python

import requests

api_key = "fc_live_your_key_here"
headers = {"Authorization": f"Bearer {api_key}"}

# Get recent filings for Apple
response = requests.get(
    "https://getfilingclarity.com/api/filings",
    headers=headers,
    params={"ticker": "AAPL", "limit": 5}
)
data = response.json()
for filing in data["filings"]:
    print(f"{filing['filing_type']} — {filing['filed_at']}")

JavaScript

const apiKey = 'fc_live_your_key_here';

fetch('https://getfilingclarity.com/api/filings?ticker=AAPL', {
  headers: { 'Authorization': `Bearer ${apiKey}` }
})
.then(r => r.json())
.then(data => console.log(data.filings));

cURL

# Recent 8-K filings for Tesla
curl -H "Authorization: Bearer fc_live_xxxx" \
  "https://getfilingclarity.com/api/filings?ticker=TSLA&type=8k&limit=10"

# Your full watchlist
curl -H "Authorization: Bearer fc_live_xxxx" \
  "https://getfilingclarity.com/api/watchlist"

API access is available on Intelligence and Portfolio plans

Pro: 1,000 requests/day at $65/mo. Elite: 5,000 requests/day, short interest data, and team seats at $150/mo.

Get started