Quickstart

Prerequisites

You need an API key. If you don’t have one, create it here.

You also need a webhook URL. Any request that triggers a fresh enrichment is refused with 400 webhook_required unless we have somewhere to deliver the result. Set one once in your API Panel, or send X-Webhook-URL per request as the examples below do.No endpoint yet? Open webhook.site, copy the URL it gives you and paste it in. It must be https://.

Prefer Postman? Download our Postman Collection to get started quickly with pre-configured requests.

Your First API Call

Basic Request

Use the domain name to fetch base data for any company:

curl -X GET "https://api.bouncewatch.com/api/v1/company/stripe.com" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-Webhook-URL: https://webhook.site/YOUR-ID"

const response = await fetch('https://api.bouncewatch.com/api/v1/company/stripe.com', {
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'X-Webhook-URL': 'https://webhook.site/YOUR-ID'
  }
});
const data = await response.json();

import requests

response = requests.get(
    'https://api.bouncewatch.com/api/v1/company/stripe.com',
    headers={
        'X-API-Key': 'YOUR_API_KEY',
        'X-Webhook-URL': 'https://webhook.site/YOUR-ID'
    }
)
data = response.json()

$ch = curl_init('https://api.bouncewatch.com/api/v1/company/stripe.com');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: YOUR_API_KEY',
    'X-Webhook-URL: https://webhook.site/YOUR-ID'
]);
$response = curl_exec($ch);
$data = json_decode($response, true);

Review the Response

A domain we have never enriched — returns 202 Accepted with a batch ID. Note the field is requested_modules on this path; a domain already in our index returns the same 202 with modules_requested and a current_data block alongside it.

{
  "success": true,
  "message": "New domain added to enrichment queue",
  "domain": "stripe.com",
  "enrichment_status": "processing",
  "batch_id": "batch_abc123xyz",
  "requested_modules": [],
  "credits_reserved": 10,
  "credits_remaining": 2490,
  "webhook_notification": "enabled",
  "status_endpoint": "https://api.bouncewatch.com/api/v1/enrichment/batch_abc123xyz/status",
  "results_endpoint": "https://api.bouncewatch.com/api/v1/enrichment/batch_abc123xyz/results"
}

No webhook configured — returns 400, and nothing is charged:

{
  "success": false,
  "error": "webhook_required",
  "message": "Webhook URL is required for enrichment requests",
  "hint": "Configure a webhook URL in your API panel at https://bouncewatch.com/api-panel/webhooks or provide it via the X-Webhook-URL header.",
  "quick_test": "For quick testing, you can get a free webhook URL from https://webhook.site"
}

Same domain within 24 hours — returns 200 OK with instant data (free):

{
  "success": true,
  "data": {
    "company": {
      "name": "Stripe",
      "domain": "stripe.com",
      "description": "Financial infrastructure for the internet",
      "founded_year": 2010,
      "employee_count": 8000,
      "headquarter_city": "San Francisco",
      "headquarter_country": "United States",
      "linkedin_url": "https://linkedin.com/company/stripe",
      "twitter_url": "https://twitter.com/stripe"
    }
  },
  "credits_used": 0,
  "dedup_note": "This domain was enriched within the last 24 hours. Cached data is returned at no charge."
}

Add Enrichments

Use the enrich parameter to get deeper data. Here’s a full enrichment request with all 6 modules:

curl -X GET "https://api.bouncewatch.com/api/v1/company/stripe.com?enrich=business,technology,funding,team,signals,competitors" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-Webhook-URL: https://webhook.site/YOUR-ID"

const response = await fetch(
  'https://api.bouncewatch.com/api/v1/company/stripe.com?enrich=business,technology,funding,team,signals,competitors', 
  { 
    headers: { 
      'X-API-Key': 'YOUR_API_KEY',
      'X-Webhook-URL': 'https://webhook.site/YOUR-ID'
    } 
  }
);
const data = await response.json();

response = requests.get(
    'https://api.bouncewatch.com/api/v1/company/stripe.com',
    headers={
        'X-API-Key': 'YOUR_API_KEY',
        'X-Webhook-URL': 'https://webhook.site/YOUR-ID'
    },
    params={'enrich': 'business,technology,funding,team,signals,competitors'}
)
data = response.json()

$ch = curl_init('https://api.bouncewatch.com/api/v1/company/stripe.com?enrich=business,technology,funding,team,signals,competitors');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: YOUR_API_KEY',
    'X-Webhook-URL: https://webhook.site/YOUR-ID'
]);
$response = curl_exec($ch);
$data = json_decode($response, true);

Full enrichment uses 60 credits: Base (10) + Business (6) + Technology (4) + Funding (10) + Team (6) + Signals (16) + Competitors (8)

You don’t have to use all modules — pick only the ones you need. For example ?enrich=funding,team costs just 26 credits.

Enrichment Modules

Choose which modules to add:

Module	Credits	What’s Included?
`business`	+6	Industry, business model, target market
`technology`	+4	Tech stack, 100+ technologies
`funding`	+10	Funding rounds, investors
`team`	+6	Team members, hiring status
`signals`	+16	39 signal types, highlights
`competitors`	+8	Competitors, similar companies

Use comma-separated values for multiple modules: ?enrich=business,technology,funding

Check Your Credit Balance

curl -X GET "https://api.bouncewatch.com/api/v1/account/credits" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch('https://api.bouncewatch.com/api/v1/account/credits', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});

response = requests.get(
    'https://api.bouncewatch.com/api/v1/account/credits',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)

$ch = curl_init('https://api.bouncewatch.com/api/v1/account/credits');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-API-Key: YOUR_API_KEY']);
$response = curl_exec($ch);
$data = json_decode($response, true);

Response

{
  "success": true,
  "data": {
    "credits": {
      "balance": 4580,
      "used": 420,
      "limit": 5000,
      "total_purchased": 0,
      "percentage_used": 8.4,
      "resets_at": "2026-02-01T09:14:22.000000Z"
    }
  }
}

Next Steps

Authentication

API key security and best practices

Credits & Modules

Credit system and module details

Company API

Full endpoint documentation and examples

Webhooks

Set up webhook to receive enrichment results

Getting Started

Core Concepts

AI Agents (MCP)

API Reference

API Playground

Prerequisites

Your First API Call

Enrichment Modules

Check Your Credit Balance

Next Steps

Authentication

Credits & Modules

Company API

Webhooks

​Prerequisites

​Your First API Call

​Enrichment Modules

​Check Your Credit Balance

​Next Steps

Authentication

Credits & Modules

Company API

Webhooks

Prerequisites

Your First API Call

Enrichment Modules

Check Your Credit Balance

Next Steps