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!

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.

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
}

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)

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": [],
  "related_companies": [],
  "public_debtor": [],
  "connected_public_debtors": [],
  "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)

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": [],
  "related_companies": [],
  "public_debtor": [],
  "connected_public_debtors": [],
  "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"
}

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

`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

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.

Requires an active subscription. Scope: procurements.

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)

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.

Requires an active subscription. Scope: search. Costs 1 API credit per call.

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
`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.