API Endpoints

All available endpoints with detailed documentation

GET /api/search

Search companies by name (case-insensitive partial match). Returns paginated results with company details.

Query Parameters
  • q string
  • limit int (default: 20)
  • offset int (default: 0)
Try it now
GET /api/company/{code}

Get complete company data by registration code. Returns all available information including financial data.

Path Parameters
  • code string (8 digits)
Try it now
GET /api/advanced-search

Search with multiple filters: name, status, location, and more. Advanced filtering capabilities.

Query Parameters
  • name string
  • status string
  • location string
POST /api/bulk-search

Search multiple companies by registration codes in a single request. Efficient for batch operations.

Request Body
  • codes string[]
GET /api/autocomplete

Get company name suggestions for autocomplete. Real-time suggestions as users type.

Query Parameters
  • q string
  • limit int (default: 10)
GET /api/stats

Get database statistics and counts. Useful for monitoring and analytics.

Try it now
GET /api/health

Check API and database health status. Returns service availability and metrics.

Try it now

Code Examples

Get started quickly with these code snippets

Python
# Search companies by name
import requests

# Basic search
response = requests.get("http://localhost:5000/api/search",
    params={"q": "tech", "limit": 5}
)
data = response.json()
print(f"Found {data['total']} companies")

# Get company by registration code
response = requests.get("http://localhost:5000/api/company/12345678")
company = response.json()
print(f"Company: {company['name']}")
JavaScript
// Search companies using fetch API
async function searchCompanies(query, limit = 20) {
    const response = await fetch(
        `/api/search?q=${query}&limit=${limit}`
    );
    const data = await response.json();
    return data;
}

// Get company by code
async function getCompany(code) {
    const response = await fetch(`/api/company/${code}`);
    return await response.json();
}
cURL
# Search for companies
curl "http://localhost:5000/api/search?q=tech&limit=5"

# Get company by registration code
curl "http://localhost:5000/api/company/12345678"

# Get API health status
curl "http://localhost:5000/api/health"

# Bulk search with POST
curl -X POST http://localhost:5000/api/bulk-search   -H "Content-Type: application/json"   -d '{"codes": ["12345678", "87654321"]}'

Features

Why choose our API for your Estonian company data needs

High Performance

Optimized PostgreSQL queries with JSONB indexing for sub-100ms response times.

Reliable & Secure

99.9% uptime with proper input validation and secure API practices.

Advanced Search

Full-text search, partial matching, and multiple filter options.

PostgreSQL JSONB

Flexible JSONB storage for complex company data structures.

RESTful API

Clean, consistent REST endpoints following best practices.

Real-time Data

Access to the latest Estonian company registry information.

Quick Start

Get up and running in minutes