GET /v1/company/:handle
Synthesized company overview from multiple sources. Returns profile data, sector classification, entity type, website summary, and recent activity.
Cost: 60 credits per call
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 is priced at its standalone rate. Bundling is a latency win, not a discount and not a surcharge.
| Section | Cost | Free when |
|---|---|---|
| overview (always) | 60 credits | never |
resources | 60 credits | never - always returns at least the X profile link |
founders | 100 credits | 0 credits when no founders are found |
funding | 60 credits | 0 credits when no funding resolves |
The zero-cost-on-empty behavior of /founders and /funding is preserved
exactly inside the composite. cost_breakdown_credits shows where the credits
actually went, 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": {}, "cost_credits": 60 },
"included": ["resources", "founders", "funding"],
"cost_breakdown_credits": {
"company_overview": 60,
"resources": 60,
"founders": 100,
"funding": 60
},
"cost_credits": 280,
"max_cost_credits": 280,
"balance_credits": 9260
}The funding section is the same schema GET /v1/company/:handle/funding
returns, so one parser works either way. Its nested cost_credits is that
section's cost; the top-level cost_credits is the whole call.
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"
}
]
},
"cost_credits": 60,
"balance_credits": 9540
}| 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. |