Name: Datreal.com Company Registry
Creator: Datreal.com
License: https://opendatacommons.org/licenses/by/1.0/

Kiirstart

API on kättesaadav ilma registreerimise või autentimiseta. Kõik otspunktid toetavad CORS-i, seega saab neid kasutada otse brauserist.

Baas-URL: https://datreal.com/api/public/v1

Otspunktid

GET

/companies/search

Otsi ettevõtteid nime, aadressi või registrikoodi järgi.

Parameetrid:

q (kohustuslik) - Otsingusõna (min. 2 tähemärki)
limit (valikuline) - Tulemuste arv (1-100, vaikimisi: 20)
country (valikuline) - Filtreeri riigikoodi järgi (LV, LT)

curl "https://datreal.com/api/public/v1/companies/search?q=tallink&country=EE&limit=5"

GET

/companies/{regcode}

Hangi detailne info konkreetse ettevõtte kohta, sealhulgas sanktsioonide staatus.

Parameetrid:

regcode (kohustuslik) - Ettevõtte registrikood

Vastus sisaldab:

Põhiinfo (nimi, aadress, õiguslik vorm)
Registreerimise ja lõpetamise kuupäevad
Maksureiting ja käibemaksu staatus
NACE kood ja kirjeldus
Finantsaruanded
Sanktsioonide staatus (isSanctioned: true/false)

curl "https://datreal.com/api/public/v1/companies/40003245752"

GET

/companies/{regcode}/sanctions

Kontrolli, kas ettevõte on sanktsioonide nimekirjas ja saa detailset infot.

Parameetrid:

regcode (kohustuslik) - Ettevõtte registrikood

curl "https://datreal.com/api/public/v1/companies/40003245752/sanctions"

GET

/companies/autofill

Hangi ettevõtte aadress ja KMKR andmed vormide automaattäitmiseks.

Parameetrid:

q (kohustuslik) - Ettevõtte nimi või registrikood (min. 2 tähemärki)
country (valikuline) - Filtreeri riigikoodi järgi (LV, LT)
limit (valikuline) - Maksimaalselt tulemusi (1-50, vaikimisi: 10)

Vastus sisaldab:

Registrikood
Ettevõtte nimi
Täielik juriidiline aadress
KMKR number (kui on registreeritud)
Riigikood (LV, LT, jne.)

curl "https://datreal.com/api/public/v1/companies/autofill?q=maxima&country=LV&limit=5"

GET

/persons/check

Kontrolli, kas konkreetsel isikul on ettevõtteid. Kasutatakse isikute jälgimiseks.

Parameetrid:

name (kohustuslik) - Isiku täisnimi (min. 2 tähemärki)
birthDate (kohustuslik) - Sünnikuupäev ISO formaadis (AAAA-KK-PP)
limit (valikuline) - Maksimaalne ettevõtete arv isiku kohta (1-100, vaikimisi: 50)

Tagastab kõik rollid: tegelik kasusaaja, ametnik, liige, omanik, mikroettevõte

curl "https://datreal.com/api/public/v1/persons/check?name=Jānis%20Bērziņš&birthDate=1985-03-15"

GET

/persons/new-registrations

Hangi uued ettevõtte registreerimised konkreetsele isikule viimase N tunni jooksul. Kasutatakse isikute jälgimiseks cron tööde kaudu.

Parameetrid:

name (kohustuslik) - Isiku täisnimi (min. 2 tähemärki)
birthDate (kohustuslik) - Sünnikuupäev ISO formaadis (AAAA-KK-PP)
hours (valikuline) - Ajavahemik tundides (1-168, vaikimisi: 24)
limit (valikuline) - Maksimaalne ettevõtete arv tagastamiseks (1-1000, vaikimisi: 100)

curl "https://datreal.com/api/public/v1/persons/new-registrations?name=Jānis%20Bērziņš&birthDate=1985-03-15&hours=24"

GET

/

API avastamise otspunkt, mis tagastab täieliku dokumentatsiooni JSON formaadis.

curl "https://datreal.com/api/public/v1"

Tehnilised detailid

CORS

Kõik otspunktid toetavad CORS-i * päritoluga, võimaldades otsest brauseri ligipääsu API-le.

Vahemälu

Vastused on vahemälus 30 minutit, 1 tund stale-while-revalidate. Päised: public, s-maxage=1800, stale-while-revalidate=3600

Päringute limiidid

Limiidid on rakendatud kuritarvitamise vältimiseks. Ettevõtte otspunktid: 20 päringut/10s. Isiku kontroll: 20 päringut/10s. Uued registreerimised: 10 päringut/60s.

Veakoodid

400 - Vigane päring (puuduvad või vigased parameetrid)
404 - Ettevõtet ei leitud
429 - Päringute limiit ületatud
500 - Serveri viga

LLM Setup Juhend

Kasuta seda juhendit AI assistentide seadistamiseks Lur.lv API-ga töötamiseks.

Kopeeri LLM jaoks

Kopeeri see viip ja sisesta see oma LLM-i (ChatGPT, Claude, jne), et võimaldada Läti ettevõtete otsingut.

# 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}
- regcode (required): Company registration number
- 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
To check sanctions: GET https://datreal.com/api/public/v1/companies/40003245752/sanctions

Otspunktid

GET

/companies/search

Otsi ettevõtteid nime, aadressi või registrikoodi järgi.

Parameetrid:

q (kohustuslik) - Otsingusõna (min. 2 tähemärki)
limit (valikuline) - Tulemuste arv (1-100, vaikimisi: 20)
country (valikuline) - Filtreeri riigikoodi järgi (LV, LT)

curl "https://datreal.com/api/public/v1/companies/search?q=tallink&country=EE&limit=5"

GET

/companies/{regcode}

Hangi detailne info konkreetse ettevõtte kohta, sealhulgas sanktsioonide staatus.

Parameetrid:

regcode (kohustuslik) - Ettevõtte registrikood

Vastus sisaldab:

Põhiinfo (nimi, aadress, õiguslik vorm)
Registreerimise ja lõpetamise kuupäevad
Maksureiting ja käibemaksu staatus
NACE kood ja kirjeldus
Finantsaruanded
Sanktsioonide staatus (isSanctioned: true/false)

curl "https://datreal.com/api/public/v1/companies/40003245752"

GET

/companies/{regcode}/sanctions

Kontrolli, kas ettevõte on sanktsioonide nimekirjas ja saa detailset infot.

Parameetrid:

regcode (kohustuslik) - Ettevõtte registrikood

curl "https://datreal.com/api/public/v1/companies/40003245752/sanctions"

GET

/companies/autofill

Hangi ettevõtte aadress ja KMKR andmed vormide automaattäitmiseks.

Parameetrid:

q (kohustuslik) - Ettevõtte nimi või registrikood (min. 2 tähemärki)
country (valikuline) - Filtreeri riigikoodi järgi (LV, LT)
limit (valikuline) - Maksimaalselt tulemusi (1-50, vaikimisi: 10)

Vastus sisaldab:

Registrikood
Ettevõtte nimi
Täielik juriidiline aadress
KMKR number (kui on registreeritud)
Riigikood (LV, LT, jne.)

curl "https://datreal.com/api/public/v1/companies/autofill?q=maxima&country=LV&limit=5"

GET

/persons/check

Kontrolli, kas konkreetsel isikul on ettevõtteid. Kasutatakse isikute jälgimiseks.

Parameetrid:

name (kohustuslik) - Isiku täisnimi (min. 2 tähemärki)
birthDate (kohustuslik) - Sünnikuupäev ISO formaadis (AAAA-KK-PP)
limit (valikuline) - Maksimaalne ettevõtete arv isiku kohta (1-100, vaikimisi: 50)

Tagastab kõik rollid: tegelik kasusaaja, ametnik, liige, omanik, mikroettevõte

curl "https://datreal.com/api/public/v1/persons/check?name=Jānis%20Bērziņš&birthDate=1985-03-15"

GET

/persons/new-registrations

Hangi uued ettevõtte registreerimised konkreetsele isikule viimase N tunni jooksul. Kasutatakse isikute jälgimiseks cron tööde kaudu.

Parameetrid:

name (kohustuslik) - Isiku täisnimi (min. 2 tähemärki)
birthDate (kohustuslik) - Sünnikuupäev ISO formaadis (AAAA-KK-PP)
hours (valikuline) - Ajavahemik tundides (1-168, vaikimisi: 24)
limit (valikuline) - Maksimaalne ettevõtete arv tagastamiseks (1-1000, vaikimisi: 100)

curl "https://datreal.com/api/public/v1/persons/new-registrations?name=Jānis%20Bērziņš&birthDate=1985-03-15&hours=24"

GET

/

API avastamise otspunkt, mis tagastab täieliku dokumentatsiooni JSON formaadis.

curl "https://datreal.com/api/public/v1"

Tehnilised detailid

CORS

Kõik otspunktid toetavad CORS-i * päritoluga, võimaldades otsest brauseri ligipääsu API-le.

Vahemälu

Vastused on vahemälus 30 minutit, 1 tund stale-while-revalidate. Päised: public, s-maxage=1800, stale-while-revalidate=3600

Päringute limiidid

Limiidid on rakendatud kuritarvitamise vältimiseks. Ettevõtte otspunktid: 20 päringut/10s. Isiku kontroll: 20 päringut/10s. Uued registreerimised: 10 päringut/60s.

Veakoodid

400 - Vigane päring (puuduvad või vigased parameetrid)
404 - Ettevõtet ei leitud
429 - Päringute limiit ületatud
500 - Serveri viga

LLM Setup Juhend

Kasuta seda juhendit AI assistentide seadistamiseks Lur.lv API-ga töötamiseks.

Kopeeri LLM jaoks

Kopeeri see viip ja sisesta see oma LLM-i (ChatGPT, Claude, jne), et võimaldada Läti ettevõtete otsingut.

# 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}
- regcode (required): Company registration number
- 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
To check sanctions: GET https://datreal.com/api/public/v1/companies/40003245752/sanctions