> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bossradar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> From a company URL to its decision makers in three calls.

## 1. Get your API key

Sign in and open the [dashboard](https://app.bossradar.com/dashboard). Your key (`brk_live_…`) is
already there — copy it. Send it on every request as the `X-API-Key` header.

## 2. Submit a company

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.bossradar.com/jobs \
    -H "X-API-Key: brk_live_..." \
    -H "Content-Type: application/json" \
    -d '{ "input": "linkedin.com/company/anthropic" }'
  ```

  ```python Python theme={null}
  import requests

  r = requests.post(
      "https://api.bossradar.com/jobs",
      headers={"X-API-Key": "brk_live_..."},
      json={"input": "linkedin.com/company/anthropic"},
  )
  print(r.json())  # { "job_id": "...", "status": "processing" }
  ```

  ```javascript Node theme={null}
  const r = await fetch("https://api.bossradar.com/jobs", {
    method: "POST",
    headers: { "X-API-Key": "brk_live_...", "Content-Type": "application/json" },
    body: JSON.stringify({ input: "linkedin.com/company/anthropic" }),
  });
  console.log(await r.json()); // { job_id, status: "processing" }
  ```
</CodeGroup>

You get back a `job_id` and `202` immediately — the work runs in the background.

## 3. Get the results — poll or webhook

<Tabs>
  <Tab title="Poll">
    ```bash theme={null}
    curl https://api.bossradar.com/jobs/<job_id> -H "X-API-Key: brk_live_..."
    # → { "status": "done", "company_id": 3384253, "result_url": "/company/3384253/dm" }

    curl https://api.bossradar.com/company/3384253/dm -H "X-API-Key: brk_live_..."
    # → { "company_id": 3384253, "count": 5, "decision_makers": [ ... ] }
    ```
  </Tab>

  <Tab title="Webhook">
    Pass `callback_url` on `POST /jobs`:

    ```bash theme={null}
    curl -X POST https://api.bossradar.com/jobs \
      -H "X-API-Key: brk_live_..." \
      -H "Content-Type: application/json" \
      -d '{ "input": "linkedin.com/company/anthropic",
            "callback_url": "https://your-server.com/hooks/bossradar" }'
    ```

    When the job is done we `POST` your URL with:

    ```json theme={null}
    { "job_id": "...", "company_id": 3384253, "status": "done", "count": 5, "decision_makers": [ ... ] }
    ```
  </Tab>
</Tabs>

<Tip>
  Try any of this live — the [API Reference](/api-reference) has an interactive playground with
  your key ready to go.
</Tip>