Company Search API

curl -X POST 'https://api.kycgenie.com/api/v2/company-search/' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: search-$(uuidgen)' \
  -d '{
    "company_name": "Acme Corporation",
    "jurisdiction": "GB"
  }'

import requests
import uuid

response = requests.post(
    'https://api.kycgenie.com/api/v2/company-search/',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Idempotency-Key': f'search-{uuid.uuid4()}'
    },
    json={
        'company_name': 'Acme Corporation',
        'jurisdiction': 'GB'
    }
)

result = response.json()
print(f"Found {result['total_results']} companies")
for company in result['results']:
    print(f"  {company['name']} ({company['registrationNumber']})")
    print(f"  ID: {company['id']}")
    print(f"  Active: {company['active']}")

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

result = client.company_search.execute(
    company_name="Acme Corporation",
    jurisdiction="GB",
)

print(f"Found {result.total_results} companies")
for company in result.results:
    print(f"  {company.name} ({company.registration_number})")
    print(f"  ID: {company.id}")
    print(f"  Active: {company.active}")

(async () => {
    const response = await fetch('https://api.kycgenie.com/api/v2/company-search/', {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/json',
            'Idempotency-Key': `search-${crypto.randomUUID()}`
        },
        body: JSON.stringify({
            company_name: 'Acme Corporation',
            jurisdiction: 'GB'
        })
    });

    const result = await response.json();
    console.log(`Found ${result.total_results} companies`);

    result.results.forEach(company => {
        console.log(`${company.name} (${company.registrationNumber})`);
        console.log(`ID: ${company.id}`);
        console.log(`Active: ${company.active}`);
    });
})();

curl -X GET 'https://api.kycgenie.com/api/v2/company-search/67625f5f3132333435363738/' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import requests

response = requests.get(
    'https://api.kycgenie.com/api/v2/company-search/67625f5f3132333435363738/',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

company = response.json()
print(f"Company: {company['name']}")
print(f"Registration: {company['registrationNumber']}")
print(f"Incorporated: {company['incorporationDate']}")

print(f"\nOfficers ({len(company.get('officers') or [])}):")
for officer in company.get('officers') or []:
    print(f"  - {officer['entityName']}: {officer['role']}")

print(f"\nOwners ({len(company.get('owners') or [])}):")
for owner in company.get('owners') or []:
    desc = (owner.get('ownershipStructure') or {}).get('descriptionString', '')
    print(f"  - {owner['entityName']} ({owner.get('entityType')}): {desc[:60]}")

from kycgenie import KYCGenie

client = KYCGenie(api_key="YOUR_API_KEY")

company = client.company_search.get_details(
    company_id="67625f5f3132333435363738",
)

print(f"Company: {company.name}")
print(f"Registration: {company.registration_number}")
print(f"Incorporated: {company.incorporation_date}")

print(f"\nOfficers ({len(company.officers or [])}):")
for officer in company.officers or []:
    print(f"  - {officer.entity_name}: {officer.role}")

print(f"\nOwners ({len(company.owners or [])}):")
for owner in company.owners or []:
    desc = owner.ownership_structure.description_string if owner.ownership_structure else ''
    print(f"  - {owner.entity_name} ({owner.entity_type}): {desc[:60]}")

(async () => {
    const companyId = '67625f5f3132333435363738';
    const response = await fetch(
        `https://api.kycgenie.com/api/v2/company-search/${companyId}/`,
        {
            headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
        }
    );

    const company = await response.json();
    console.log(`Company: ${company.name}`);
    console.log(`Registration: ${company.registrationNumber}`);
    console.log(`Incorporated: ${company.incorporationDate}`);

    console.log(`\nOfficers (${company.officers?.length || 0}):`);
    company.officers?.forEach(officer => {
        console.log(`  - ${officer.entityName}: ${officer.role}`);
    });

    console.log(`\nOwners (${company.owners?.length || 0}):`);
    company.owners?.forEach(owner => {
        const ownership = owner.ownershipPercentage || 0;
        console.log(`  - ${owner.entityName}: ${ownership}%`);
    });
})();