GET /v1/company/:handle
Synthesized company overview from multiple sources. Returns profile data, sector classification, entity type, website summary, and recent activity.
Cost: Draws on your monthly usage.
curl "https://frontrun.vc/v1/company/stealth_ai_co" \
-H "X-API-Key: your_api_key"Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
handle | string (path) | -- | X username of the company. Required. |
include | string (query) | -- | Comma-separated sections to bundle into this one call: resources, founders, funding. See below. |
max_credits | integer (query) | -- | Cap what this call may cost. Checked against the worst case for the sections you asked for, before any work runs. See Budgets & Cursors. |
Composite lookups with include
A full picture of one company used to be four calls at four prices. include
folds them into one round trip.
curl "https://frontrun.vc/v1/company/stealth_ai_co?include=resources,founders,funding&max_credits=300" \
-H "X-API-Key: your_api_key"Each section draws the same usage as its standalone endpoint. Bundling is a latency win, not a discount and not a surcharge.
| Section | Free when |
|---|---|
| overview (always) | never |
resources | never - always returns at least the X profile link |
founders | free when no founders are found |
funding | free when no funding resolves |
The free-on-empty behavior of /founders and /funding is preserved
exactly inside the composite, and everything is charged in a single deduction, so a composite
never leaves you half-billed for a response you did not receive.
include=founders uses the same cached founder join as
GET /v1/search?include_founders=true: fast, batched, with a background
resolve kicked off on a cold miss. It does not perform the up-to-28-second
live discovery wait that GET /v1/company/:handle/founders does, so a cold
company returns resolution_status: "resolving" in this section. Call the
dedicated endpoint when you need the blocking resolve.
An unknown section name returns 400 with error_code: "invalid_include".
Composite response
{
"company": { "handle": "stealth_ai_co", "name": "StealthAI", "...": "..." },
"resources": { "website": "https://stealthai.com", "twitter": "https://x.com/stealth_ai_co", "github": "https://github.com/stealthai" },
"founders": { "company": "stealth_ai_co", "total_found": 2, "founders": [] },
"funding": { "schema_version": "2026-07-29", "found": true, "latest_round": {} },
"included": ["resources", "founders", "funding"],
"usage_pct": 12,
"usage_resets_at": "2026-11-01T00:00:00Z"
}The funding section is the same schema GET /v1/company/:handle/funding
returns, so one parser works either way.
Response
{
"company": {
"handle": "stealth_ai_co",
"name": "StealthAI",
"bio": "Automating enterprise workflows with LLMs",
"website": "https://stealthai.com",
"sector": "AI/ML",
"entity_type": "startup",
"about": "StealthAI builds AI agents that automate back-office workflows for mid-market enterprises. Founded in 2025, the company has processed over 2M tasks for 50+ customers.",
"website_summary": "Product page describes an AI workflow automation platform with integrations for Salesforce, HubSpot, and Slack. Pricing starts at $500/mo.",
"recent_activity": [
{
"type": "new_vc_follower",
"date": "2026-03-25",
"detail": "Followed by a]16z"
},
{
"type": "profile_update",
"date": "2026-03-20",
"detail": "Bio updated to mention Series A"
}
]
},
"usage_pct": 12,
"usage_resets_at": "2026-11-01T00:00:00Z"
}| Field | Type | Description |
|---|---|---|
entity_type | string | One of "startup", "growth_company", "enterprise", "vc_fund", "accelerator", "media", "individual". |
about | string | AI-synthesized summary from bio, website, and social signals. |
recent_activity | array | Notable recent events related to this company. |