Use Cases

Practical guides for common CompanyData API workflows: lead generation, KYC, autocomplete, address lookup, and corporate hierarchies. Each guide includes copy-pasteable code and example JSON responses.

Company Search & Autocomplete

Build a company search autocomplete for registration forms, CRM data entry, and B2B applications.

Address Search

Find companies by address using city lookup, street name, and postal code filters.

Due Diligence & KYC

Verify companies for compliance, onboarding, and risk assessment. Includes registration verification and ownership checks.

Sales & Lead Generation

Build targeted B2B lead lists using filters for industry, company size, location, and contact availability.

Corporate Structure

Retrieve and visualize the complete corporate hierarchy of any company, including all subsidiaries and parent relationships.

Quick Start

All examples use native fetch and work in both Node.js 18+ and browsers. Here's the basic pattern:

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://app.companydata.com/api/company';

async function fetchApi<T>(endpoint: string, params: Record<string, string | number>): Promise<T> {
  const url = new URL(`${BASE_URL}/${endpoint}`);
  Object.entries(params).forEach(([key, value]) => {
    if (value) url.searchParams.append(key, String(value));
  });

  const response = await fetch(url.toString(), {
    headers: { 'x-api-key': API_KEY },
  });

  if (!response.ok) {
    throw new Error(`HTTP ${response.status}: ${await response.text()}`);
  }

  return response.json();
}

// Search for companies
const searchResults = await fetchApi('search', { search: 'Philips', countryCode: 'NL' });

// Get full company details
const companyDetails = await fetchApi('export', { ID: '407809109' });

Need Help?

Was this page helpful?