Filing Intelligence API

Programmatic access to analyzed SEC filings, insider trades, and company data for 7,600+ US small-cap stocks. RESTful JSON endpoints with simple API key authentication.

All API requests require an API key sent as a Bearer token in the Authorization header. API access is available on the Pro plan. You can generate and manage API keys from your dashboard.

curl -H "Authorization: Bearer your_api_key_here" \
  https://brefyr.com/api/v1/filings

The Pro plan includes 1,000 API calls per day. Rate limit headers are included in every response:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 997
X-RateLimit-Reset: 1700000000

If you exceed your limit, requests return 429 Too Many Requests until the daily reset at midnight UTC.

Endpoints

{
  "data": [...],
  "meta": {
    "count": 42,
    "offset": 0,
    "limit": 50,
    "days": 30
  }
}

{
  "data": [...],
  "meta": {
    "count": 100,
    "offset": 0,
    "limit": 100
  }
}

{
  "data": [...],
  "meta": {
    "count": 58,
    "offset": 0,
    "limit": 50,
    "days": 30
  }
}

Code Examples

# Fetch high-significance filings for a stock
curl -H "Authorization: Bearer your_api_key_here" \
  "https://brefyr.com/api/v1/filings?ticker=AAPL&min_significance=7&days=30"

# Search companies by sector
curl -H "Authorization: Bearer your_api_key_here" \
  "https://brefyr.com/api/v1/companies?sector=Technology&limit=10"

# Export filing data as CSV
curl -H "Authorization: Bearer your_api_key_here" \
  "https://brefyr.com/api/v1/export?ticker=AAPL&days=90" \
  -o filings.csv

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://brefyr.com/api/v1"

headers = {"Authorization": f"Bearer {API_KEY}"}

# Get recent high-significance filings
response = requests.get(
    f"{BASE_URL}/filings",
    headers=headers,
    params={
        "ticker": "AAPL",
        "min_significance": 7,
        "days": 30,
    },
)
data = response.json()

for filing in data["data"]:
    print(f"{filing['ticker']} — {filing['filing_type']} — Score: {filing['significance_score']}")
    print(f"  {filing['one_line_summary']}")
    print()

const API_KEY = "your_api_key_here";
const BASE_URL = "https://brefyr.com/api/v1";

async function getFilings(ticker, days = 30) {
  const params = new URLSearchParams({
    ticker,
    days: String(days),
    min_significance: "5",
  });

  const response = await fetch(`${BASE_URL}/filings?${params}`, {
    headers: { "Authorization": `Bearer ${API_KEY}` },
  });

  if (!response.ok) {
    throw new Error(`API error: ${response.status}`);
  }

  return response.json();
}

const data = await getFilings("AAPL");
console.log(`Found ${data.meta.count} filings`);

Response Format

All endpoints return JSON with consistent structure. Filing objects include computed fields like significance_score and one_line_summary.

{
  "data": [
    {
      "id": "fil_abc123",
      "ticker": "AAPL",
      "company_name": "Apple Inc.",
      "filing_type": "10-K",
      "filed_date": "2025-10-30",
      "significance_score": 8,
      "one_line_summary": "Annual report reveals 12% revenue growth driven by services segment, with new risk disclosures around AI regulatory compliance.",
      "ai_summary_prose": "Apple's fiscal year 2025 10-K filing shows total revenue of $412B...",
      "has_earnings_data": true,
      "insider_data": null,
      "raw_url": "https://www.sec.gov/Archives/edgar/data/..."
    }
  ],
  "meta": {
    "count": 50,
    "offset": 0,
    "limit": 50,
    "days": 30
  }
}

Error responses include an error field with a human-readable message:

{
  "error": "Invalid or missing API key"
}