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.
GET /api/v1/search?q={query}&limit=10
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
Available500 calls / mo
Included with every free account. Create a key on your account page.
Starter
Manual tier10K calls / mo
Online billing is not live yet. Contact us and we will raise your limit manually.
Growth
Manual tier100K 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
| Status | Code | Meaning |
|---|---|---|
| 400 | missing_query | Search needs q. |
| 401 | missing_api_key / invalid_api_key | No key, or the key is wrong or revoked. |
| 404 | not_found | No company with that slug. Use search. |
| 429 | rate_limited / quota_exceeded | Burst limit or monthly quota reached. |
| 502 | upstream | The 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.