API Overview

async function getCompanyData(domain) {
  try {
    const response = await fetch(
      `https://api.bouncewatch.com/api/v1/company/${domain}`,
      { headers: {
        'X-API-Key': API_KEY,
        'X-Webhook-URL': WEBHOOK_URL
      }}
    );

    const data = await response.json();

    // 202 — enrichment queued. Results arrive at your webhook.
    if (response.status === 202) {
      return { status: 'enriching', batch_id: data.batch_id };
    }

    if (!data.success) {
      switch (data.error) {
        case 'insufficient_credits':
          console.log(`Need ${data.credits_required}, have ${data.credits_available}`);
          break;
        case 'rate_limit_exceeded':
          console.log(`Rate limited. Retry after ${data.retry_after}s`);
          break;
        case 'webhook_required':
          console.log('Configure an https webhook URL first');
          break;
        case 'recently_enriched':
        case 'enrichment_in_progress':
          // Not a failure: the data is on its way, or already free to fetch.
          console.log(`Deduplicated: ${data.message}`);
          break;
        default:
          console.log(`${data.error}: ${data.message}`);
      }
      return null;
    }

    return data.data;
  } catch (error) {
    console.error('Network error:', error);
    return null;
  }
}

import requests

def get_company_data(domain):
    try:
        response = requests.get(
            f'https://api.bouncewatch.com/api/v1/company/{domain}',
            headers={'X-API-Key': API_KEY, 'X-Webhook-URL': WEBHOOK_URL}
        )
        data = response.json()

        # 202 — enrichment queued. Results arrive at your webhook.
        if response.status_code == 202:
            return {'status': 'enriching', 'batch_id': data['batch_id']}

        if not data['success']:
            error = data.get('error')
            if error == 'insufficient_credits':
                print(f"Need {data['credits_required']}, have {data['credits_available']}")
            elif error == 'rate_limit_exceeded':
                print(f"Rate limited. Retry after {data['retry_after']}s")
            elif error == 'webhook_required':
                print('Configure an https webhook URL first')
            elif error in ('recently_enriched', 'enrichment_in_progress'):
                # Not a failure: deduplicated, nothing was charged.
                print(f"Deduplicated: {data['message']}")
            else:
                print(f"{error}: {data['message']}")
            return None

        return data['data']
    except requests.RequestException as e:
        print(f"Network error: {e}")
        return None

function getCompanyData($domain) {
    $ch = curl_init("https://api.bouncewatch.com/api/v1/company/{$domain}");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'X-API-Key: ' . API_KEY,
        'X-Webhook-URL: ' . WEBHOOK_URL,
    ]);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($response === false) {
        echo "Network error\n";
        return null;
    }

    $data = json_decode($response, true);

    // 202 — enrichment queued. Results arrive at your webhook.
    if ($httpCode === 202) {
        return ['status' => 'enriching', 'batch_id' => $data['batch_id']];
    }

    if (!$data['success']) {
        switch ($data['error']) {
            case 'insufficient_credits':
                echo "Need {$data['credits_required']}, have {$data['credits_available']}\n";
                break;
            case 'rate_limit_exceeded':
                echo "Rate limited. Retry after {$data['retry_after']}s\n";
                break;
            case 'webhook_required':
                echo "Configure an https webhook URL first\n";
                break;
            case 'recently_enriched':
            case 'enrichment_in_progress':
                // Not a failure: deduplicated, nothing was charged.
                echo "Deduplicated: {$data['message']}\n";
                break;
            default:
                echo "{$data['error']}: {$data['message']}\n";
        }
        return null;
    }

    return $data['data'];
}