# GET /v1/company/:handle

> Source: https://www.frontrun.vc/docs/endpoints/company
> Raw markdown: https://www.frontrun.vc/raw/docs/endpoints/company.md
> Full docs (single file): https://www.frontrun.vc/llms-full.txt

Synthesized company overview from multiple sources. Returns profile data, sector classification, entity type, website summary, and recent activity.

**Cost:** Draws on your monthly usage.

```bash
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](/docs/reference/budgets-and-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.

```bash
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

```json
{
  "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

```json
{
  "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. |