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]
    }
  ]
}

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
  }
}

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.