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:
- Create an account or log in to bizlist.gr
- Navigate to your Account page
- Scroll to the "API Keys" section
- Click "Create New API Key" and give it a descriptive name
- Copy your API key immediately - you won't be able to see it again!
Authentication
All API requests must be authenticated using your API key in the request header:
X-API-Key: your_api_key_hereExample Request
curl https://bizlist.gr/api/v1/companies/gr/200000000000 \ -H "X-API-Key: your_api_key_here"
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
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
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
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
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
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
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
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)
mode | string | sell or buy |
seat | string | Optional. Where your business is established: GR (default), an EU country code (e.g. IT) or NONEU |
item | string | What you sell or buy, an id from the include_items list (e.g. professional_services, hotels, used_cars) |
counterparty | string | GR, EU or NONEU: the customer when you sell, the seller when you buy |
counterparty_country | string | EU country code (e.g. DE) when counterparty=EU. With a seat outside Greece, your own country is allowed (a domestic sale) |
buyer_type | string | B2B or B2C: your customer, or you when you buy |
island | string | Your seat, if it is a Greek island with reduced VAT (e.g. Λέσβος) |
counterparty_vat | string | Optional. 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_items | boolean | Optional. Also returns the item list (items: groups with id, label and hint) for this mode and counterparty |
place, on_site, pickup, over_10k, exempt | boolean | Optional. 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
Companies incorporated within a date range. Useful for monitoring new businesses by sector or area.
Scope: search.
Query Parameters
days | number | Last X days. Alternatively use start_date / end_date |
start_date | string | Start date, YYYY-MM-DD |
end_date | string | End date, YYYY-MM-DD |
count | number | Number of results (default: 100) |
start | number | Offset for pagination (default: 0) |
status | string | Company status (default: active) |
has_email | boolean | Only companies with an email (default: true) |
address | string | Filter by address |
country | string | Registry country code |
sort / order | string | Sort field (default: date_start) and direction (default: desc) |
Company Public Procurement
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/:page | GET | Pagination by category: awards, contracts, payments, requests, announcements |
/api/v1/procurements/item/:adam | GET | Details of a single record by its ADAM identifier |
/api/v1/procurements/connected/:adam | GET | Linked records (amendments, executive contracts) |
Sector Statistics
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
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
subsidies | array | Newest first. Per row: source_name (espa, sorefsis, cordis, kohesio, fts), project_title, programme, total_cost, eu_contribution, start_date, end_date |
subsidies[].merged_sources | array | The same aid in ESPA and Sorefsis, as one row. Amount and dates from Sorefsis |
subsidies[].is_contractor_project | boolean | ESPA project where the company is a contractor, not the beneficiary |
espa_pending, sorefsis_pending | boolean | The source is refreshing in the background. New data comes with the next call |
Related Endpoints
/api/v1/subsidies/item/:id | GET | Details of one subsidy |
/api/v1/subsidies/project/:project_id | GET | EU project with all participants |
Company News
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
page | number | Page, from 1 (optional) |
per_page | number | Articles per page, default 5, max 50 (optional) |
Response
articles | array | Per article: title, url, source, published_date, group_size and sources (all sources with the same article) |
total, total_pages | number | Number of articles and pages |
Get Current 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)
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.