# CargoBEN — European Open Freight & Logistics Registry

> CargoBEN (cargoben.com) is the open European logistics database and registry of heavy road freight carriers (>3.5t) and industrial shippers/manufacturers. Data is verified directly from official Czech state registers (ARES & Ministry of Transport Road Freight Carriers Registry).

## Core System Overview
- **Platform URL**: https://cargoben.com
- **Coverage**: Czech Republic (28,386+ active logistics entities) & Central European freight routes (CZ, DE, SK, AT, FR, IT).
- **Access**: 100% Free public access for search, company verification, and profile management.

## Datasets & Entity Types

### 1. Heavy Road Freight Carriers (CZ-NACE 49410)
- **Total Entities**: 15,187 verified companies
- **Criteria**: Licensed heavy truck operators (>3.5t GVWR), tautliners, frigorific/reefer trailers, mega trailers, ADR transport.
- **Key Attributes**: IČO (8-digit ID), Company Name, City, Region, VAT/DPH status, Fleet size indicator, verified ARES registration.

### 2. Industrial Shippers & Manufacturers (CZ-NACE Section C & G46)
- **Total Entities**: 13,199 verified companies
- **Criteria**: Industrial manufacturers, wholesale distributors, and high-volume freight shippers requiring freight transport services.

## Key Web Pages & Endpoints

- [Main Registry & Search Console](https://cargoben.com/): Unified search engine for companies by IČO, company name, city, or NACE classification.
- [Company Profile Endpoint](https://cargoben.com/company/{ico}): Detailed profile view for any carrier or shipper identified by 8-digit IČO.
- [Public Search API](https://cargoben.com/api/search): JSON API endpoint returning live search results.
  - Query parameter `q`: Free-text search string (IČO, name, city).
  - Query parameter `type`: `all` | `carrier` | `shipper`.
  - Query parameter `limit`: Number of results (default: 24).
- [Profile Claim API](https://cargoben.com/api/claim): Endpoint for company owners/dispatchers to claim, verify, and update their free company profile.

## Data Schemas & Fields

Each company entry in CargoBEN contains the following structured fields:
- `ico`: String (8-digit unique Czech company identifier, e.g., "00005886")
- `company_name`: String (Cleaned legal business name)
- `company_type`: "carrier" | "shipper"
- `legal_form_name`: String (Legal entity classification, e.g., "Společnost s ručením omezeným", "Akciová společnost")
- `city`: String (Municipality/City of registration)
- `street_address`: String (Full legal registration address)
- `nace_code`: String (CZ-NACE economic classification code, e.g., "49410")
- `dph_status`: "AKTIVNI" (VAT registered) | "NEAKTIVNI"
- `fleet_category`: String (Vehicle fleet indicator)

## Contact & Governance
- **Publisher**: CargoBEN Platform
- **Contact Email**: ben@cargoben.com
- **Data Source**: Official Czech State API (ARES REST API) & Ministry of Transport Czech Republic