BizList.gr API Documentation

Welcome to the BizList.gr API documentation. This API provides programmatic access to Greek business data, including company information, financial data, people, and activities.

Getting Started

To use the BizList.gr API, you'll need an API key. Follow these steps:

  1. Create an account or log in to bizlist.gr
  2. Navigate to your Account page
  3. Scroll to the "API Keys" section
  4. Click "Create New API Key" and give it a descriptive name
  5. Copy your API key immediately - you won't be able to see it again!
Note: You can create up to 5 API keys per account. Each key can be revoked independently.

Authentication

All API requests must be authenticated using your API key in the request header:

X-API-Key: your_api_key_here

Example Request

curl https://bizlist.gr/api/v1/companies/gr/200000000000 \
  -H "X-API-Key: your_api_key_here"
Security: Keep your API keys secure. Never commit them to version control or share them publicly.

Rate Limits & Credits

Each successful API call (200 OK response) consumes 1 API credit from your account. On the company profile, each of include_all_financial_years, include_enrichment, include_online_presence, include_related_companies, include_subsidies, include_procurement, include_risk and include_sector_stats adds 1 API credit.

  • API credits are deducted from your personal credits first, then from organization credits (if applicable)
  • Check your credit balance on your Account page
  • No credits are charged for failed requests (4xx, 5xx errors)

Endpoints That Don't Consume Credits

The following endpoints do not consume API credits:

  • User info endpoint (/api/v1/user)
  • Export endpoints (/api/v1/export/leads/*)

API Endpoints

Search Companies

GET /api/v1/search

Search for companies by name, VAT ID, or other criteria.

Query Parameters

query string Search query (company name, VAT, etc.)
count number Number of results to return (default: 30)
page number Page number for pagination (default: 1)

Example Response

{
  "results": [
    {
      "type": "company",
      "id": 12345,
      "vat": "EL123456789",
      "ar_gemh": 100000000000,
      "name": "EXA... AUTOMATION SERVICES Ι.Κ.Ε.",
      "namei18n": "EXA... AUTOMATION SERVICES I.K.E.",
      "status": 1,
      "legal_type": {"name": "ΙΚΕ", "name_i18n": "Private Company", "abbr_i18n": "PC"},
      "region": "ΑΘΗ...",
      "city": "ΑΘΗ..."
    }
  ],
  "total_count": 2
}

Advanced Search

POST /api/v1/companies/advanced-search

The filters of Advanced Search: activity, location, legal type, revenue, assets, founding date, contact details and more. Filters go in a JSON body. The search_companies tool of the MCP server takes the same filters.

Scope: search. 1 API credit per call.

Example Request

curl -X POST https://api.bizlist.gr/api/v1/companies/advanced-search \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "country": "GR",
    "status": "active",
    "legal_types": ["10", "4", "7"],
    "revenue_min": 1500000,
    "revenue_max": 100000000,
    "date_start_to": "-3y",
    "count": 50,
    "start": 0
  }'

Filters (JSON body)

Parameter Type Description
query string Free text search query (company name, etc.)
country string Registry country: "GR", "BG", "CY" or "IE". Omit for all countries
activities string[] Array of KAD/NACE activity codes (e.g. ["56101100","56301000"]). Use search_activities to find codes.
activities_main_only boolean Only match main activity (not secondary)
regions string[] Array of region names
cities string[] Array of city names (in Greek, uppercase, e.g. ["ΑΘΗΝΑ","ΘΕΣΣΑΛΟΝΙΚΗ"])
municipality string Municipality name
zip_code string Postal code
street string Street name
street_number string Street number
date_start_from string Company founded after this date (YYYY-MM-DD or relative like "-30d")
date_start_to string Company founded before this date (YYYY-MM-DD or relative like "-30d")
status string Company status: "active" (default), "inactive", or "all"
legal_types string[] Legal type ids as strings. Common: "10" ΑΕ (SA), "4" ΙΚΕ, "7" ΕΠΕ, "13" ΟΕ, "11" ΕΕ, "14" sole proprietorship, "3" branch of foreign company. Others: `legal_type.id` of any company
excluded_legal_types string[] Legal type ids to exclude (e.g. ["3"] = no branches of foreign companies)
revenue_min number Minimum revenue in EUR, latest balance sheet
revenue_max number Maximum revenue in EUR, latest balance sheet
assets_min number Minimum total assets in EUR, latest balance sheet
assets_max number Maximum total assets in EUR, latest balance sheet
profit_min number Minimum profit in EUR, latest balance sheet. 0 = profitable only. Premium only
profit_max number Maximum profit in EUR, latest balance sheet. 0 = loss-making only. Premium only
dso_min number Minimum days sales outstanding (days to collect from customers), latest balance sheet; only companies that print trade receivables
dso_max number Maximum days sales outstanding, latest balance sheet
dso_ratio_min number Minimum trade receivables / revenue as a ratio (0.25 = receivables are 25% of annual revenue), latest balance sheet; only companies that print trade receivables
dso_ratio_max number Maximum trade receivables / revenue as a ratio, latest balance sheet
dpo_ratio_min number Minimum trade payables (owed to suppliers) / revenue as a ratio (0.25 = 25% of annual revenue), latest balance sheet. A scale measure, not days to pay: revenue is not purchases
dpo_ratio_max number Maximum trade payables / revenue as a ratio, latest balance sheet
chambers string[] Chamber of commerce ids the company is registered with
special_categories string[] Special registers and tags the company must belong to. One or more of: suspended, public_debtors (large tax debtors), elevate_greece (registered startups), pep (politically exposed persons), sanctioned, exporter (official exporters register, NOT "does exports"), listed (Athens stock exchange), energy_operating, energy_progress, energy_self, energy_storage, energy_ets, energy_ev, plus content tags such as pos_provider, press, efet_registry, insurance_registry, servicers, payment_agent, energy
website_filter string Website state: "has", "rich" (live site with content), "poor" (parked/abandoned), "not_found"
website_pattern string Full domain, e.g. "example.gr", or a name without TLD, e.g. "example". Exact match, not a substring. Also matches sites found outside the registry
email_pattern string Email must contain this text, e.g. "gmail.com"
email_exact string Exact email address
phone string Exact 10-digit Greek phone number
has_email boolean|"no" true = only companies with email, "no" = only companies without email
has_phone boolean|"no" true = only companies with phone, "no" = only companies without phone
exclude_accountant_email boolean Exclude companies whose listed email belongs to their accountant (rather than the company itself). Useful for outreach hygiene — accountant emails are common in GEMI filings but rarely the right contact for sales/business outreach.
exclude_accountant_phone boolean Exclude companies whose listed phone belongs to their accountant rather than the company itself. Same rationale as exclude_accountant_email.
contracts_min number Minimum number of public contracts awarded (a count; use contracts_total_min for value)
contracts_total_min number Minimum total value of public contracts in EUR
contracts_total_max number Maximum total value of public contracts in EUR
public_years number Look-back window in years for the public money filters (default 3)
public_org_slug string Only contracts awarded by this buyer (public organisation slug)
subsidies_min number Minimum NUMBER of national/EU subsidy awards received (a count, not an amount)
research_min number Minimum NUMBER of EU research programmes participated in (a count, not an amount)
google_ads "active" | "past" | "inactive" Google ads (Transparency Center): "active" = running now, "past" = ran before but not now, "inactive" = not running now
meta_ads "active" | "past" | "inactive" Facebook/Instagram ads (Meta Ad Library): "active" = running now, "past" = ran before but not now, "inactive" = not running now
profiles ("facebook" | "instagram" | "tiktok" | "youtube" | "linkedin")[] Only companies that have a profile on ALL of these platforms
profiles_none ("facebook" | "instagram" | "tiktok" | "youtube" | "linkedin")[] Only companies that have NO profile on any of these platforms
google_maps "has" | "none" "has" = has a Google Maps listing, "none" = has not
rating_min number Minimum Google Maps rating (1-5)
rating_max number Maximum Google Maps rating (1-5), e.g. 3 for poorly rated
reviews_min number Minimum number of Google Maps reviews
jobs_min number Minimum number of distinct roles in open online job ads (job boards, LinkedIn, careers pages; last 45 days). 1 = has open job ads. Online ads only, not all hiring
job_categories ("sales" | "customer_service" | "it" | "engineering" | "finance" | "admin" | "marketing" | "hr" | "logistics" | "drivers" | "hospitality" | "health" | "trades" | "cleaning_security" | "education" | "legal" | "other")[] Only count open job ads in these role categories (classified from the ad title), e.g. ["it"] for companies looking for developers. Implies jobs_min 1 when jobs_min is not set
gps_center_lat number GPS latitude for radius search
gps_center_lon number GPS longitude for radius search
gps_radius_km number Search radius in km. Only companies with a street- or village-level location are returned; companies whose address could only be placed at a city centre are excluded
vat string VAT number
ar_gemh string AR GEMH number
sort_field string Sort by: "date_start", "name", "revenue", "profit", "assets", "google_rating"
sort_direction string "asc" or "desc"
start number Pagination offset (default 0)
count number Results per call (default 20, max 50; 20 without premium)

Response

total_count with the number of all matches and results with the companies of the page. Each company has its search fields and latest financials (revenue, revenue_year, assets). For the full profile and the latest 3 fiscal years, call /api/v1/companies/:country/:ar_gemh.

Get Company by Registry Number

GET /api/v1/companies/:country/:ar_gemh

Retrieve detailed information about a company using the country code and registry number.

URL Parameters

country string Country code (gr, cy, ie, bg)
ar_gemh string Company registry number

Query Parameters

update boolean Set to true to force fresh data update from source (optional)
include_all_financial_years boolean Set to true for all fiscal years. Without it, financials has the latest 3 and financials_omitted counts the rest. Adds 1 API credit (optional)
include_enrichment boolean Set to true for enrichment: website, brand, social profiles, additional emails, logo. Adds 1 API credit (optional)
include_online_presence boolean Set to true for presence and google_places: Google rating, visits, ads, followers. Adds 1 API credit (optional)
include_related_companies boolean Set to true for related_companies: subsidiaries and companies of the same people. Adds 1 API credit (optional)
include_subsidies boolean Set to true for subsidies_summary: the 20 most recent subsidies. All of them, with details, at /api/v1/subsidies/:vat. Adds 1 API credit (optional)
include_procurement boolean Set to true for procurement_summary: count and value of public contract awards. Details at /api/v1/procurements/:vat. Adds 1 API credit (optional)
include_sector_stats boolean Set to true for sector_stats: official statistics of the main activity with source links, up to 4, and more_count for the rest, along with candles: revenue, margin and days sales/payables/inventory outstanding and cash conversion cycle percentiles (dso, dpo, dio, with zero_pct for companies at 0 days, kept out of the percentiles, and ccc, which can be negative) of the Greek companies of the sector from their filings (p10 to p90, and p1, p99 from 100 companies up), with n per measure, year and the code of the level. articles gives up to 3 BizList.gr analyses about the sector, with title, url, published. Each statistic has a country and a company gets only its own country, today Greek companies only. All of them at /api/v1/activities/:code/stats (1 API credit). Adds 1 API credit (optional)
include_risk boolean Set to true for all registry risk signals: insolvency, aade_violations, public_debtor, connected_public_debtors, risk_flags (sanctions, PEP) and auctions (upcoming, upcoming_count, upcoming_properties, past_count, last_date as YYYY-MM). Without it these fields are left out, with a risk_notice: no field does not mean no risk. Adds 1 API credit (optional)
include_vies boolean Set to true for a live VAT check in VIES (vies_status). Free (optional)

Example Response

{
  "id": 98765,
  "vat": "EL987654321",
  "ar_gemh": 200000000000,
  "name": "EXA... COMPANY Ι.Κ.Ε.",
  "namei18n": "EXA... COMPANY I.K.E.",
  "status": 1,
  "date_start": "2020-01-15 00:00:00",
  "legal_type": {"name": "ΙΚΕ", "name_i18n": "Private Company", "abbr_i18n": "PC"},
  "region": "ΑΘΗ...",
  "city": "ΑΘΗ...",
  "municipality": "ΑΘΗ... / ΑΘΗ...",
  "zip_code": "10000",
  "street": "ΠΑΝ...",
  "street_number": "12",
  "website": "www.exa...com",
  "email": "inf...@exa...com",
  "phone": "210123...",
  "email_is_accountant": 0,
  "phone_is_accountant": 0,
  "chamber": null,
  "last_update": "2025-11-20 10:00:00",
  "data_source": "Γενικό Εμπορικό Μητρώο",
  "registration_suspended": 0,
  "objective": "Η σχε..., κατ..., ανά..., εισ..., εξα..., εκμ... και εμπ... ηλε... και ηλε... συσ...",
  "activities": [
    {
      "activity": 123,
      "is_main": 1,
      "id": 123,
      "code": "62011200",
      "description": "ΥΠΗ... ΣΧΕ... ΚΑΙ ΑΝΑ... ΤΕΧ... ΤΗΣ ΠΛΗ... ΓΙΑ ΔΙΚ... ΚΑΙ ΣΥΣ..."
    }
  ],
  "titles": ["EXA... CO."],
  "people": [
    {
      "person": {
        "id": 54321,
        "vat": "EL111222333",
        "first_name": "ΓΙΑ...",
        "last_name": "ΠΑΠ...",
        "is_company": 0
      },
      "company": 98765,
      "date_from": "2020-01-15T00:00:00.000Z",
      "date_to": null,
      "is_active": 1,
      "capacity": "Μέλος & Διαχειριστής",
      "percentage": "100.00000"
    }
  ],
  "documents": [
    {
      "id": 11111,
      "name": "B5 2024",
      "period_start": "2024-01-01T00:00:00.000Z",
      "period_end": "2024-12-31T00:00:00.000Z",
      "upload_time": "2025-01-15T10:00:00.000Z",
      "filename": "~/uploads/00/200000000000/B5 2024.pdf",
      "url": "https://publicity.businessportal.gr/api/download/financial/1234567?companyId=200000000000",
      "balance_sheet_id": 99999
    }
  ],
  "financials": [],
  "data_license": {
    "source": "GEMI",
    "source_url": "https://publicity.businessportal.gr/company/1234567",
    "license": "ODC-BY-1.0",
    "license_url": "https://opendatacommons.org/licenses/by/1-0/",
    "applies_to": "Registry data only: identifiers, name, legal form, status, dates, address, registry email and phone, activities, people, capital and filing records. Other fields have other sources and are not covered."
  },
  "risk_notice": "Registry risk signals (insolvency, aade_violations, public_debtor, connected_public_debtors, risk_flags, auctions) are left out because they were not requested. This does not mean there is no risk. Set include_risk=true for them (+1 API credit).",
  "is_authenticated": false
}

Get Company by VAT ID

GET /api/v1/companies/by-vat/:vat_id

Retrieve detailed information about a company using its VAT ID. The VAT ID can be provided with or without the "EL" prefix.

URL Parameters

vat_id string Company VAT identification number (with or without "EL" prefix)

Query Parameters

update boolean Set to true to force fresh data update from source (optional)
include_all_financial_years boolean Set to true for all fiscal years. Without it, financials has the latest 3 and financials_omitted counts the rest. Adds 1 API credit (optional)
include_enrichment boolean Set to true for enrichment: website, brand, social profiles, additional emails, logo. Adds 1 API credit (optional)
include_online_presence boolean Set to true for presence and google_places: Google rating, visits, ads, followers. Adds 1 API credit (optional)
include_related_companies boolean Set to true for related_companies: subsidiaries and companies of the same people. Adds 1 API credit (optional)
include_subsidies boolean Set to true for subsidies_summary: the 20 most recent subsidies. All of them, with details, at /api/v1/subsidies/:vat. Adds 1 API credit (optional)
include_procurement boolean Set to true for procurement_summary: count and value of public contract awards. Details at /api/v1/procurements/:vat. Adds 1 API credit (optional)
include_sector_stats boolean Set to true for sector_stats: official statistics of the main activity with source links, up to 4, and more_count for the rest, along with candles: revenue, margin and days sales/payables/inventory outstanding and cash conversion cycle percentiles (dso, dpo, dio, with zero_pct for companies at 0 days, kept out of the percentiles, and ccc, which can be negative) of the Greek companies of the sector from their filings (p10 to p90, and p1, p99 from 100 companies up), with n per measure, year and the code of the level. articles gives up to 3 BizList.gr analyses about the sector, with title, url, published. Each statistic has a country and a company gets only its own country, today Greek companies only. All of them at /api/v1/activities/:code/stats (1 API credit). Adds 1 API credit (optional)
include_risk boolean Set to true for all registry risk signals: insolvency, aade_violations, public_debtor, connected_public_debtors, risk_flags (sanctions, PEP) and auctions (upcoming, upcoming_count, upcoming_properties, past_count, last_date as YYYY-MM). Without it these fields are left out, with a risk_notice: no field does not mean no risk. Adds 1 API credit (optional)
include_vies boolean Set to true for a live VAT check in VIES (vies_status). Free (optional)

Example Response

{
  "id": 98765,
  "vat": "",
  "ar_gemh": 200000000000,
  "name": "EXA... COMPANY Ι.Κ.Ε.",
  "namei18n": "EXA... COMPANY I.K.E.",
  "status": 1,
  "date_start": "2020-01-15 00:00:00",
  "legal_type": {"name": "ΙΚΕ", "name_i18n": "Private Company", "abbr_i18n": "PC"},
  "region": "ΑΘΗ...",
  "city": "ΑΘΗ...",
  "municipality": "ΑΘΗ... / ΑΘΗ...",
  "zip_code": "10000",
  "street": "ΠΑΝ...",
  "street_number": "12",
  "website": "www.exa...com",
  "email": "inf...@exa...com",
  "phone": "210123...",
  "email_is_accountant": 0,
  "phone_is_accountant": 0,
  "chamber": null,
  "last_update": "2025-11-20 10:00:00",
  "data_source": "Γενικό Εμπορικό Μητρώο",
  "registration_suspended": 0,
  "objective": "Η σχε..., κατ..., ανά..., εισ..., εξα..., εκμ... και εμπ... ηλε... και ηλε... συσ...",
  "activities": [
    {
      "activity": 123,
      "is_main": 1,
      "id": 123,
      "code": "62011200",
      "description": "ΥΠΗ... ΣΧΕ... ΚΑΙ ΑΝΑ... ΤΕΧ... ΤΗΣ ΠΛΗ... ΓΙΑ ΔΙΚ... ΚΑΙ ΣΥΣ..."
    }
  ],
  "titles": ["EXA... CO."],
  "people": [
    {
      "person": {
        "id": 54321,
        "vat": "EL111222333",
        "first_name": "ΓΙΑ...",
        "last_name": "ΠΑΠ...",
        "is_company": 0
      },
      "company": 98765,
      "date_from": "2020-01-15T00:00:00.000Z",
      "date_to": null,
      "is_active": 1,
      "capacity": "Μέλος & Διαχειριστής",
      "percentage": "100.00000"
    }
  ],
  "documents": [
    {
      "id": 11111,
      "name": "B5 2024",
      "period_start": "2024-01-01T00:00:00.000Z",
      "period_end": "2024-12-31T00:00:00.000Z",
      "upload_time": "2025-01-15T10:00:00.000Z",
      "filename": "~/uploads/00/200000000000/B5 2024.pdf",
      "url": "https://publicity.businessportal.gr/api/download/financial/1234567?companyId=200000000000",
      "balance_sheet_id": 99999
    }
  ],
  "financials": [],
  "data_license": {
    "source": "GEMI",
    "source_url": "https://publicity.businessportal.gr/company/1234567",
    "license": "ODC-BY-1.0",
    "license_url": "https://opendatacommons.org/licenses/by/1-0/",
    "applies_to": "Registry data only: identifiers, name, legal form, status, dates, address, registry email and phone, activities, people, capital and filing records. Other fields have other sources and are not covered."
  },
  "risk_notice": "Registry risk signals (insolvency, aade_violations, public_debtor, connected_public_debtors, risk_flags, auctions) are left out because they were not requested. This does not mean there is no risk. Set include_risk=true for them (+1 API credit).",
  "is_authenticated": false
}

Get Person Details

GET /api/v1/people/:person_id

Retrieve information about a person by their ID.

URL Parameters

person_id number Person's unique identifier

Example Response

{
  "id": 54321,
  "vat": "EL111222333",
  "first_name": "ΓΙΑ...",
  "last_name": "ΠΑΠ...",
  "is_company": 0,
  "companies": [
    {
      "person": 54321,
      "company": 98765,
      "date_from": "2020-01-15T00:00:00.000Z",
      "date_to": null,
      "is_active": true,
      "capacity": "Μέλος & Διαχειριστής",
      "percentage": "100.00000",
      "id": 98765,
      "vat": "",
      "ar_gemh": 200000000000,
      "name": "EXA... COMPANY Ι.Κ.Ε.",
      "namei18n": "EXA... COMPANY I.K.E.",
      "status": 1,
      "date_start": "2020-01-15 00:00:00",
      "legal_type": {"name": "ΙΚΕ", "name_i18n": "Private Company", "abbr_i18n": "PC"},
      "region": "ΑΘΗ...",
      "city": "ΑΘΗ...",
      "municipality": "ΑΘΗ... / ΑΘΗ...",
      "zip_code": "10000",
      "street": "ΠΑΝ...",
      "street_number": "12",
      "website": "www.exa...com",
      "email": "inf...@exa...com",
      "phone": "210123...",
      "email_is_accountant": 0,
      "phone_is_accountant": 0,
      "chamber": 1,
      "last_update": "2025-11-20 10:00:00",
      "data_source": "Γενικό Εμπορικό Μητρώο",
      "registration_suspended": 0,
      "activities": [
        {
          "activity": 123,
          "is_main": 1,
          "id": 123,
          "code": "62011200",
          "description": "ΥΠΗ... ΣΧΕ... ΚΑΙ ΑΝΑ... ΤΕΧ... ΤΗΣ ΠΛΗ... ΓΙΑ ΔΙΚ... ΚΑΙ ΣΥΣ..."
        }
      ],
      "titles": ["EXA... CO."],
      "public_debtor": [],
      "connected_public_debtors": [],
      "people": [54321]
    }
  ]
}

VAT Number Check via VIES

GET /api/v1/vies/:vat_id

Validates an EU VAT number through VIES, returning the trading name and address where the member state publishes them. Results are cached, so repeated checks of the same number do not hit the Commission service every time.

Scope: vat_check. Accepts any member-state format, e.g. EL094002320.

Example Response

{
  "vat_id": "EL094002320",
  "country_code": "EL",
  "is_valid": 1,
  "name": "UNIBIOS ΑΝΩΝΥΜΟΣ ΕΤΑΙΡΕΙΑ ΣΥΜΜΕΤΟΧΩΝ||UNIBIOS",
  "address": "1Η ΚΑΙ 18Η ΟΔΟΣ 0  13341 - ΑΝΩ ΛΙΟΣΙΑ",
  "verified_at": "2026-09-03T12:14:56.000Z",
  "last_checked_at": "2026-09-03T12:14:56.000Z"
}

VAT Treatment of a Sale or Purchase

POST /api/v1/vat

For a business that sells or buys in Greece, the EU or outside the EU: the VAT on the invoice, what to do, the invoice wording, the myDATA code, the returns to file and the legal basis (Greek VAT Code, Law 5144/2024, and Directive 2006/112/EC). For a business established in another EU country or outside the EU (seat), the answer follows the VAT Directive only: national rules, myDATA and the Greek VAT Code are not included. The same answer as the page VAT calculator. A general rule, not tax advice.

Scope: vat_check. Query lang=en for an answer in English.

Fields (JSON body)

modestringsell or buy
seatstringOptional. Where your business is established: GR (default), an EU country code (e.g. IT) or NONEU
itemstringWhat you sell or buy, an id from the include_items list (e.g. professional_services, hotels, used_cars)
counterpartystringGR, EU or NONEU: the customer when you sell, the seller when you buy
counterparty_countrystringEU country code (e.g. DE) when counterparty=EU. With a seat outside Greece, your own country is allowed (a domestic sale)
buyer_typestringB2B or B2C: your customer, or you when you buy
islandstringYour seat, if it is a Greek island with reduced VAT (e.g. Λέσβος)
counterparty_vatstringOptional. The customer's or seller's VAT number: checked in VIES (and in our registry for Greek numbers), it sets counterparty, country and buyer_type. The result is in vies
include_itemsbooleanOptional. Also returns the item list (items: groups with id, label and hint) for this mode and counterparty
place, on_site, pickup, over_10k, exemptbooleanOptional. The response asks for them in fields when they change the VAT (place of supply, on site on an island, pickup at the shop, the €10,000 threshold, an exempt buyer)

Example Request

curl -X POST "https://api.bizlist.gr/api/v1/vat?lang=en" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"mode": "sell", "item": "professional_services", "counterparty_vat": "DE811569869"}'

Example Response

{
  "vies": { "vat_number": "DE811569869", "valid": true, "counterparty": "EU", "counterparty_country": "DE", "buyer_type": "B2B", "message": "Valid in VIES" },
  "fields": { "ask_exempt": false, "ask_over_10k": false, "ask_pickup": false, "place_options": [], ... },
  "answer": {
    "vat_lines": [["VAT on the invoice", "0% (you charge no VAT)", null]],
    "head": "No VAT: reverse charge. The customer declares the VAT in their country.",
    "steps": ["Check the customer's VAT number in VIES and keep the result.", "Issue an invoice without VAT, with the customer's VAT number."],
    "invoice": "Reverse charge.",
    "mydata": "VAT category 7 (0%), exemption reason 4 (\"Without VAT - article 18 of the VAT Code\").",
    "declare": ["The sale goes in the periodic VAT return.", "Recapitulative statement of services supplied (VIES) every month."],
    "legal_gr": "Greek VAT Code (Law 5144/2024) arts 18(2)(α), 41(5); ...",
    "notes": [],
    "summary": "Services of lawyers, accountants, ... VAT on the invoice: 0% (you charge no VAT). ...",
    "rates_note": null
  },
  "disclaimer": "A general rule, not tax or legal advice. ..."
}

fields tells which optional fields change the answer (e.g. ask_over_10k, place_options). A wrong value returns 400 with the field in error.

Rates of other EU countries come from the European Commission's TEDB database (CC BY 4.0) with our own corrections and may be incomplete. When the answer shows such a rate, rates_note says so. Every answer carries a disclaimer.

Newly Registered Companies

GET /api/v1/companies/new

Companies incorporated within a date range. Useful for monitoring new businesses by sector or area.

Scope: search.

Query Parameters

daysnumberLast X days. Alternatively use start_date / end_date
start_datestringStart date, YYYY-MM-DD
end_datestringEnd date, YYYY-MM-DD
countnumberNumber of results (default: 100)
startnumberOffset for pagination (default: 0)
statusstringCompany status (default: active)
has_emailbooleanOnly companies with an email (default: true)
addressstringFilter by address
countrystringRegistry country code
sort / orderstringSort field (default: date_start) and direction (default: desc)

Company Public Procurement

GET /api/v1/procurements/:vat

Awards, contracts and payments from the Greek public sector to a company, with aggregate totals. :vat is a nine-digit Greek VAT number, with or without the EL prefix.

Scope: procurements. 1 API credit per call.

Related Endpoints

/api/v1/procurements/:vat/:category/:pageGETPagination by category: awards, contracts, payments, requests, announcements
/api/v1/procurements/item/:adamGETDetails of a single record by its ADAM identifier
/api/v1/procurements/connected/:adamGETLinked records (amendments, executive contracts)

Sector Statistics

GET /api/v1/activities/:code/stats

Official statistics (ELSTAT, Eurostat, Bank of Greece) that cover one KAD/NACE code, in priority order: last 12 values, scope with what the source covers, is_stale and source links, candles with the revenue, margin and days sales/payables/inventory outstanding and cash conversion cycle percentiles of the Greek companies of the sector, and articles with up to 3 BizList.gr analyses about the sector. :code is 2 to 8 digits. The optional ?country= sets the country (default GR, the only one with data today). The company profile with include_sector_stats=true returns the same shape, with the first 4 for its main activity.

1 API credit per call.

Company Subsidies

GET /api/v1/subsidies/:vat

All subsidies of a company: ESPA, Sorefsis (the Greek state aid register), CORDIS, Kohesio and FTS. :vat is a nine-digit Greek VAT number, with or without the EL prefix. The company profile with include_subsidies=true returns only the 20 most recent, in short form.

1 API credit per call.

Response

subsidiesarrayNewest first. Per row: source_name (espa, sorefsis, cordis, kohesio, fts), project_title, programme, total_cost, eu_contribution, start_date, end_date
subsidies[].merged_sourcesarrayThe same aid in ESPA and Sorefsis, as one row. Amount and dates from Sorefsis
subsidies[].is_contractor_projectbooleanESPA project where the company is a contractor, not the beneficiary
espa_pending, sorefsis_pendingbooleanThe source is refreshing in the background. New data comes with the next call

Related Endpoints

/api/v1/subsidies/item/:idGETDetails of one subsidy
/api/v1/subsidies/project/:project_idGETEU project with all participants

Company News

GET /api/v1/companies/:company_id/articles

Press articles that mention the company, newest first. :company_id is the id field of the company profile, not the AR GEMH. The same article from several sources comes as one row.

1 API credit per call.

Query Parameters

pagenumberPage, from 1 (optional)
per_pagenumberArticles per page, default 5, max 50 (optional)

Response

articlesarrayPer article: title, url, source, published_date, group_size and sources (all sources with the same article)
total, total_pagesnumberNumber of articles and pages

Get Current User

GET /api/v1/user

Get information about the currently authenticated user (you).

Example Response

{
  "id": 999,
  "email": "use...@exa...com",
  "is_premium": true,
  "credits": {
    "user": {
      "ai_credits": 5,
      "lead_credits": 10,
      "api_credits": 15
    },
    "org": {
      "ai_credits": 100,
      "lead_credits": 500,
      "api_credits": 250
    }
  },
  "organization": {
    "id": 50,
    "name": "EXA... Systems",
    "domain": "exa...com"
  },
  "org_permissions": {
    "is_admin": 0,
    "can_spend_ai_credits": 1,
    "can_spend_leads_credits": 1,
    "can_spend_api_credits": 1
  }
}

Full Company Profile for LLMs (Markdown)

GET /api/v1/companies/:country/:ar_gemh/llm

Everything about the company as a single text/plain document, built for consumption by language models and agents. One call replaces five: identity, activity codes, objective, up to six financial years with every column, computed ratios, sector medians, officers, related companies, branches, public procurement, grants, job postings, stock listing and press coverage.

The response is roughly 12-15 KB, against 100-400 KB for /api/v1/companies/:country/:ar_gemh in JSON, without the heavy fields (graph, timeline, documents) a model does not need.

Scope: search. Costs 1 API credit per call. Registry risk signals (insolvency, ΑΑΔΕ violations, public debt, sanctions, PEP, property auctions) come only with include_risk=true, which adds 1 API credit.

Example

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.bizlist.gr/api/v1/companies/gr/757001000/llm

Example Response

# ΕΤΑΙΡΕΙΑ ΑΕ

- **ΑΦΜ:** EL123456789
- **ΓΕΜΗ:** 757001000
- **Νομική μορφή:** ΑΕ
- **Κατάσταση:** Ενεργή
- **Κύριος ΚΑΔ:** 62011100 ΥΠΗΡΕΣΙΕΣ ΣΧΕΔΙΑΣΜΟΥ ΛΟΓΙΣΜΙΚΟΥ

## Financial statements

| Χρήση | Τζίρος | Κέρδη προ φόρων | Ενεργητικό | Ίδια κεφάλαια |
| --- | --- | --- | --- | --- |
| 2024 | 14.233.504 | 2.852.493 | 18.897.849 | 6.120.000 |

### Ratios

| Χρήση | Μεικτό % | Καθαρό % | ROA % | Health 0-100 |
| --- | --- | --- | --- | --- |
| 2024 | 43,93 | 20,04 | 15,09 | 71 |
...

Error Handling

The API uses standard HTTP status codes to indicate success or failure:

Status Code Description
200 Success - Request completed successfully
400 Bad Request - Invalid parameters or malformed request
401 Unauthorized - Invalid or missing API key
402 Payment Required - Insufficient API credits
403 Forbidden - TERMS_NOT_ACCEPTED: log in and accept the updated terms
404 Not Found - Resource doesn't exist
429 Too Many Requests - Rate limit exceeded
500 Internal Server Error - Something went wrong on our end

Error Response Format

{
  "error": "Error message description"
}

Need Help?

If you have questions or need assistance with the API, please contact us.

Also available on the RapidAPI marketplace.