API Playground

Get company data

Returns company data for a domain, enriching it first when we do not already hold something recent.

Two outcomes, and both are success:

200 — the domain was enriched within the last 24 hours, so you get the data straight away and spend 0 credits.
202 — nothing recent on file, so enrichment is queued. Credits are reserved now; results arrive at your webhook, or you poll status_endpoint.

A 409 is normal too: we deduplicate per domain, so a second request while one is in flight is refused rather than charged twice.

A webhook URL is required for anything that triggers enrichment — send X-Webhook-URL here, or store one once via POST /account/webhook.

GET

company

{domain}

Get company data

curl --request GET \
  --url https://api.bouncewatch.com/api/v1/company/{domain} \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.bouncewatch.com/api/v1/company/{domain}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bouncewatch.com/api/v1/company/{domain}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "success": true,
  "data": {
    "company": {
      "name": "Stripe",
      "domain": "stripe.com",
      "description": "Financial infrastructure for the internet",
      "founded_year": 2010,
      "employee_count": 8000
    },
    "funding": {
      "total_funding": 8700000000,
      "funding_stage": "Series I"
    }
  },
  "credits_used": 0,
  "from_recent_enrichment": true,
  "credits_remaining": 4500
}

Authorizations

X-API-Key

string

header

required

Your API key, from the API Panel.

Headers

X-Webhook-URL

string<uri>

Where to deliver the results. Must be https://. Overrides the URL stored on the account. Required unless one is already stored — without either, enrichment is refused with 400 webhook_required before any credits are spent.

Example:

"https://webhook.site/YOUR-ID"

Path Parameters

domain

string

required

Company domain. stripe.com, www.stripe.com and https://stripe.com/pricing all resolve to the same company.

Example:

"stripe.com"

Query Parameters

enrich

string

Comma-separated enrichment modules. Base data (10 credits) is always included; each module adds its own cost. Requesting all six costs 60 credits.

Example:

"funding,team"

Response

Enriched within the last 24 hours — served from cache, 0 credits.

success

boolean

Example:

true

data

object

The enriched company. Which keys are present depends on the modules requested — see Response Schema for the full shape.

Example:

{
  "company": {
    "name": "Stripe",
    "domain": "stripe.com",
    "description": "Financial infrastructure for the internet",
    "founded_year": 2010,
    "employee_count": 8000
  },
  "funding": {
    "total_funding": 8700000000,
    "funding_stage": "Series I"
  }
}

credits_used

integer

0 when served from the 24-hour cache.

Example:

0

from_recent_enrichment

boolean

Example:

true

credits_remaining

integer

Example:

4500

Get company data

curl --request GET \
  --url https://api.bouncewatch.com/api/v1/company/{domain} \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.bouncewatch.com/api/v1/company/{domain}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bouncewatch.com/api/v1/company/{domain}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "success": true,
  "data": {
    "company": {
      "name": "Stripe",
      "domain": "stripe.com",
      "description": "Financial infrastructure for the internet",
      "founded_year": 2010,
      "employee_count": 8000
    },
    "funding": {
      "total_funding": 8700000000,
      "funding_stage": "Series I"
    }
  },
  "credits_used": 0,
  "from_recent_enrichment": true,
  "credits_remaining": 4500
}

Getting Started

Core Concepts

AI Agents (MCP)

API Reference

API Playground

Get company data

Authorizations

Headers

Path Parameters

Query Parameters

Response