# CompanyBook.bg

> Bulgarian company registry providing comprehensive data on companies and individuals through a public API

CompanyBook.bg is a searchable database of Bulgarian companies and people, sourced from the official Bulgarian Trade Register. Access detailed company information including management, ownership, financial data, addresses, and historical changes.

## API Documentation

- [Full API Documentation](https://companybook.bg/api-docs): Complete reference for all endpoints, parameters, and response formats
- [Full LLMs File](https://companybook.bg/llms-full.txt): Another file like this but will full API examples and request/response bodies and parameters

## Key Features

- Search and retrieve Bulgarian companies by UIC (Unique Identification Code)
- Access person profiles with company relationships and roles
- Query by district, legal form, status, and other filters
- Historical tracking of company changes
- RESTful JSON API with comprehensive data models

## Main API Endpoints

### Companies
- GET /api/companies/:uic - Get company by UIC
- GET /api/companies/search - Search companies with filters (name, district, status, legal_form, etc.)
- GET /api/companies/documents/:uic - Get company document data (financial statements, AJ and BH documents)
- GET /api/companies/:uic/download - Download specific company documents (requires authentication)
- GET /api/companies/count - Get total companies count

### People
- GET /api/people/:indent - Get person by identifier (EGN/LNCh)
- GET /api/people/search - Search people by name
- GET /api/people/count - Get total people count

### Unified Search
- GET /api/shared/search - Search both companies and people simultaneously

### Relationships
- GET /api/relationships/:identifier - Get network graph of ownership and management relationships

## Data Included

Companies: Name, UIC, legal form, status, address, contacts, management, ownership, capital info, NKID codes, VAT registration, insolvency/liquidation status
People: Name, identifier, affiliated companies, roles (manager, partner, board member, etc.)

## General information

- Base API URL: https://api.companybook.bg/api
- All endpoints support `with_data=true` parameter for expanded details
- Response format: JSON with pagination support via `limit``
- 28 Bulgarian districts supported (Sofia, Plovdiv, Varna, Burgas, etc.)
- 18 legal forms (OOD, EOOD, AD, EAD, sole traders, foundations, etc.)