API v1

TargetDossier API

Company profiles, five-year financials and live filings for public companies, as JSON. Every field links to the source it came from.

Get an API keySee endpoints

Quick start

1. Sign in and create a key under API keys on your account page. 2. Send it as a Bearer token:

curl https://targetdossier.com/api/v1/companies/apple \
  -H "Authorization: Bearer td_live_YOUR_KEY"

Authentication

Send your key in the Authorization: Bearer header (or X-API-Key). Keys start with td_live_. We store only a hash, so a lost key can't be recovered: revoke it and create a new one. Keep keys on your server; never put them in browser code.

Endpoints

Base URL https://targetdossier.com/api/v1. All endpoints are GET and return JSON.

Find covered companies by name or ticker. Returns the slug you use in the other endpoints, plus ticker, CIK, industry, HQ and latest revenue. limit is 1 to 50.

curl "https://targetdossier.com/api/v1/search?q=nvda" -H "Authorization: Bearer $TD_KEY"

GET /api/v1/companies/{slug}

The dossier as data: identifiers, summary, key metrics, products, leadership, up to five fiscal years of financials (USD, as reported), competitors, risks, federal-contract total, the five latest filings and the source list. coverage is full for pre-built dossiers and live for profiles built on request (fewer fields).

{
  "data": {
    "slug": "apple",
    "name": "Apple",
    "legal_name": "Apple Inc.",
    "ticker": "AAPL",
    "cik": 320193,
    "hq": "Cupertino, CA",
    "industry": "Electronic Computers",
    "kpis": [{ "label": "Revenue (FY2025)", "value": "$416B", "as_of": "2025-09-27" }, ...],
    "financials": [{ "fy": "2025", "end": "2025-09-27", "rev": 416161000000, "ni": 112010000000, ... }],
    "leadership": [...], "competitors": [...], "risks": [...],
    "recent_filings": [{ "form": "4", "date": "2026-10-15", "desc": "...", "url": "https://www.sec.gov/..." }],
    "sources": [...],
    "coverage": "full"
  }
}

GET /api/v1/companies/{slug}/filings?form=8-K&since=2026-01-01&limit=25

Recent filings, fetched live (cached up to 30 minutes): form, filing date, report date, accession number, 8-K items, description and document URL. Filter by form and since (YYYY-MM-DD); limit is 1 to 100.

curl "https://targetdossier.com/api/v1/companies/tesla/filings?form=8-K&limit=5" \
  -H "Authorization: Bearer $TD_KEY"

Plans and limits

Each call counts toward your account's monthly quota (UTC calendar month). Every response carries X-RateLimit-Limit and X-RateLimit-Remaining. There is also a burst limit of 60 requests a minute per key.

Developer

Available
$0 / month

500 calls / mo

Included with every free account. Create a key on your account page.

Starter

Manual tier
$49 / month

10K calls / mo

Online billing is not live yet. Contact us and we will raise your limit manually.

Growth

Manual tier
$199 / month

100K calls / mo

Online billing is not live yet. Contact us and we will raise your limit manually.

Webhooks for the Growth tier are planned, not built.

Errors

StatusCodeMeaning
400missing_querySearch needs q.
401missing_api_key / invalid_api_keyNo key, or the key is wrong or revoked.
404not_foundNo company with that slug. Use search.
429rate_limited / quota_exceededBurst limit or monthly quota reached.
502upstreamThe upstream filings service did not answer. Retry shortly.

Errors look like {"error": {"code": "not_found", "message": "..."}}. Data is for research and is not investment advice; see the terms.