API Documentation
Public API for company information, sanctions checks, and person monitoring. Free access to Latvian company registry data.
Quick Start
The API is available without registration or authentication. All endpoints support CORS, so they can be used directly from the browser.
Base URL: https://datreal.com/api/public/v1
Endpoints
/companies/search
Search companies by name, address or registration number.
Parameters:
q(required) - Search query (min. 2 characters)limit(optional) - Result count (1-100, default: 20)country(optional) - Filter by country code (LV, LT, EE, FI)
curl "https://datreal.com/api/public/v1/companies/search?q=tallink&country=EE&limit=5"/companies/{regcode}
Get detailed information about a specific company, including sanctions status.
Parameters:
regcode(required) - Company registration numbercountry(optional) - Filter by country code (LV, LT, EE, FI)
Response includes:
- Basic information (name, address, legal form)
- Registration and closure dates
- Taxpayer rating and VAT status
- NACE code and description
- Financial reports
- Sanctions status (isSanctioned: true/false)
curl "https://datreal.com/api/public/v1/companies/40003245752?country=LV"/companies/{regcode}/sanctions
Check if a company is on the sanctions list and get detailed information.
Parameters:
regcode(required) - Company registration number
curl "https://datreal.com/api/public/v1/companies/40003245752/sanctions"/companies/autofill
Get company address and VAT data for form autofill. Optimized for address autocomplete in hobby projects.
Parameters:
q(required) - Company name or registration number (min. 2 characters)country(optional) - Filter by country code (LV, LT, EE, FI)limit(optional) - Max results (1-50, default: 10)
Response includes:
- Registration number (regcode)
- Company name
- Full legal address
- VAT number (if registered)
- Country code (LV, LT, etc.)
curl "https://datreal.com/api/public/v1/companies/autofill?q=maxima&country=LV&limit=5"/persons/check
Check if a specific person has any company registrations. Used for monitoring specific people.
Parameters:
name(required) - Person's full name (min. 2 characters)birthDate(required) - Birth date in ISO format (YYYY-MM-DD)limit(optional) - Max companies per person (1-100, default: 50)
Returns all roles: beneficial owner, officer, member, stockholder, micro-enterprise
curl "https://datreal.com/api/public/v1/persons/check?name=Jānis%20Bērziņš&birthDate=1985-03-15"/persons/new-registrations
Get new company registrations for a specific person in the last N hours. Used for monitoring specific people via cron jobs.
Parameters:
name(required) - Person's full name (min. 2 characters)birthDate(required) - Birth date in ISO format (YYYY-MM-DD)hours(optional) - Time window in hours (1-168, default: 24)limit(optional) - Max companies to return (1-1000, default: 100)
curl "https://datreal.com/api/public/v1/persons/new-registrations?name=Jānis%20Bērziņš&birthDate=1985-03-15&hours=24"/
API discovery endpoint that returns full documentation in JSON format.
curl "https://datreal.com/api/public/v1"Technical Details
CORS
All endpoints support CORS with * origin, allowing direct browser access to the API.
Caching
Responses are cached for 30 minutes with 1 hour stale-while-revalidate. Headers: public, s-maxage=1800, stale-while-revalidate=3600
Rate Limits
Rate limits are applied to prevent abuse. Company endpoints: 20 req/10s. Person check: 20 req/10s. New registrations: 10 req/60s.
Error Codes
400- Invalid request (missing or invalid parameters)404- Company not found429- Rate limit exceeded500- Server error
LLM Setup Guide
Use this guide to configure AI assistants and language models to work with the Lur.lv API. The prompt below contains all the information an LLM needs to understand and use the API correctly.
Copy for LLM
Copy this prompt and paste it into your LLM (ChatGPT, Claude, etc.) to enable it to use the Lur.lv API for Latvian company lookups.
# Datreal.com API Integration Guide
You are integrating with the Datreal.com public API for Latvian company data. Here is everything you need to know:
## Base URL
https://datreal.com/api/public/v1
## Authentication
No authentication required. The API is publicly accessible.
## Available Endpoints
### 1. Search Companies
GET /companies/search?q={query}&limit={limit}
- q (required): Search query, minimum 2 characters
- limit (optional): Results count, 1-100, default 20
- Returns: Array of matching companies with regcode, name, address, status
### 2. Get Company Details
GET /companies/{regcode}?country={country}
- regcode (required): Company registration number
- country (optional): Country code to disambiguate duplicates (LV, LT, EE, FI)
- Returns: Full company details including financials, tax rating, VAT status, sanctions status
### 3. Check Sanctions
GET /companies/{regcode}/sanctions
- regcode (required): Company registration number
- Returns: Sanctions status and list of any active sanctions
### 4. Check Person
GET /persons/check?name={name}&birthDate={birthDate}&limit={limit}
- name (required): Full name, minimum 2 characters
- birthDate (required): ISO format YYYY-MM-DD
- limit (optional): Max companies, 1-100, default 50
- Returns: All company associations (board member, shareholder, beneficial owner, etc.)
### 5. New Registrations
GET /persons/new-registrations?name={name}&birthDate={birthDate}&hours={hours}&limit={limit}
- name (required): Full name
- birthDate (required): ISO format YYYY-MM-DD
- hours (optional): Time window 1-168, default 24
- limit (optional): Max results 1-1000, default 100
- Returns: New company registrations for the person within the time window
## Rate Limits
- Company endpoints: 20 requests per 10 seconds
- Person check: 20 requests per 10 seconds
- New registrations: 10 requests per 60 seconds
## Response Format
All responses are JSON. Successful responses return 200 OK.
## Error Codes
- 400: Invalid request (missing or invalid parameters)
- 404: Company or person not found
- 429: Rate limit exceeded
- 500: Server error
## CORS
All endpoints support CORS with * origin, allowing direct browser access.
## Caching
Responses are cached for 30 minutes with stale-while-revalidate of 1 hour.
## Example Usage
To search for a company: GET https://datreal.com/api/public/v1/companies/search?q=example&limit=10
To get company details: GET https://datreal.com/api/public/v1/companies/40003245752?country=LV
To check sanctions: GET https://datreal.com/api/public/v1/companies/40003245752/sanctionsMCP Server (Claude, AI Agents)
Connect Claude Desktop, Claude Code, or any MCP-compatible AI client directly to our company data using the Model Context Protocol (MCP). No API keys needed.
What is MCP?
The Model Context Protocol (MCP) is an open standard that lets AI assistants like Claude directly access external data sources and tools. Instead of copying API responses, the AI can query company data autonomously.
MCP Server Endpoint
Server URL (Streamable HTTP):
https://datreal.com/api/mcpAvailable Tools
search_companiesSearch companies by name, address, or registration number across LV, LT, EE, FI.
get_company_detailsGet full company info: name, address, legal form, VAT, tax rating, NACE code, sanctions, officers, and latest financials.
get_company_financialsGet multi-year financial statements: revenue, profit, assets, equity, employees, liabilities, and cash flow.
get_company_complianceGet VAT number, tax rating, sanctions status, tax debt, blacklist status, and all compliance flags.
Setup for Claude Desktop
Add the following to your Claude Desktop configuration file:
Config file location:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{ "mcpServers": { "datreal": { "type": "url", "url": "https://datreal.com/api/mcp" } }}Setup for Claude Code
Run this command in your terminal to add the MCP server to Claude Code:
claude mcp add datreal --transport http https://datreal.com/api/mcpExample Usage
Once connected, you can ask Claude questions like:
- •"What is the revenue of SIA Maxima Latvija?"
- •"Show me the financial history of company 40003245752"
- •"Is this company sanctioned? Check regcode 40003245752"
- •"Find Estonian companies named Bolt"
Compatible AI Clients
Any MCP-compatible client can connect to this server, including:
- ✓Claude Desktop & Claude Code (Anthropic)
- ✓Cursor IDE
- ✓Custom MCP clients built with the MCP SDK