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

Greita pradžia

API prieinamas be registracijos ar autentifikacijos. Visi taškai palaiko CORS, todėl gali būti naudojami tiesiogiai iš naršyklės.

Bazinis URL: https://datreal.com/api/public/v1

Galutiniai taškai

GET

/companies/search

Ieškoti įmonių pagal pavadinimą, adresą arba registracijos numerį.

Parametrai:

q (privaloma) - Paieškos užklausa (min. 2 simboliai)
limit (neprivaloma) - Rezultatų skaičius (1-100, numatytasis: 20)
country (neprivaloma) - Filtruoti pagal šalies kodą (LV, LT)

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

GET

/companies/{regcode}

Gauti išsamią informaciją apie konkrečią įmonę, įskaitant sankcijų statusą.

Parametrai:

regcode (privaloma) - Įmonės registracijos numeris

Atsakymas apima:

Pagrindinė informacija (pavadinimas, adresas, teisinė forma)
Registracijos ir uždarymo datos
Mokesčių mokėtojo reitingas ir PVM statusas
NACE kodas ir aprašymas
Finansinės ataskaitos
Sankcijų statusas (isSanctioned: true/false)

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

GET

/companies/{regcode}/sanctions

Tikrinti, ar įmonė yra sankcijų sąraše, ir gauti detalią informaciją.

Parametrai:

regcode (privaloma) - Įmonės registracijos numeris

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

GET

/companies/autofill

Gaukite įmonės adreso ir PVM duomenis formų pildymui. Optimizuota laisvalaikio projektams.

Parametrai:

q (privaloma) - Įmonės pavadinimas arba kodas (min. 2 simboliai)
country (neprivaloma) - Filtruoti pagal šalies kodą (LV, LT)
limit (neprivaloma) - Maks. rezultatų (1-50, numatytasis: 10)

Atsakymas apima:

Įmonės kodas
Įmonės pavadinimas
Pilnas juridinis adresas
PVM kodas (jei registruota)
Šalies kodas (LV, LT ir kt.)

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

GET

/persons/check

Tikrinti, ar asmuo turi susijusių įmonių registracijų. Naudojama specifinių asmenų stebėsenai.

Parametrai:

name (privaloma) - Asmens vardas ir pavardė (min. 2 simboliai)
birthDate (privaloma) - Gimimo data ISO formatu (MMMM-MM-DD)
limit (neprivaloma) - Maks. įmonių asmeniui (1-100, numatytasis: 50)

Grąžina visus vaidmenis: tikrasis naudos gavėjas, vadovas, narys, akcininkas

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

GET

/persons/new-registrations

Gauti naujas asmens įmonių registracijas per paskutines N valandų. Naudojama specifinių asmenų stebėsenai per cron jobs.

Parametrai:

name (privaloma) - Asmens vardas ir pavardė (min. 2 simboliai)
birthDate (privaloma) - Gimimo data ISO formatu (MMMM-MM-DD)
hours (neprivaloma) - Laiko langas valandomis (1-168, numatytasis: 24)
limit (neprivaloma) - Maks. grąžinamų įmonių (1-1000, numatytasis: 100)

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

GET

/

API atradimo taškas, grąžinantis pilną dokumentaciją JSON formatu.

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

Techninė informacija

CORS

Visi taškai palaiko CORS su * kilme, leisdami tiesioginę prieigą iš naršyklės.

Kešavimas

Atsakymai saugomi talpykloje 30 minučių su 1 valandos 'stale-while-revalidate'. Antraštės: public, s-maxage=1800, stale-while-revalidate=3600

Užklausų limitai

Taikomi užklausų limitai siekiant išvengti piktnaudžiavimo. Įmonių taškai: 20 req/10s. Asmens patikra: 20 req/10s. Naujos registracijos: 10 req/60s.

Klaidų kodai

400 - Neteisinga užklausa (trūksta arba neteisingi parametrai)
404 - Įmonė nerasta
429 - Viršytas užklausų limitas
500 - Serverio klaida

LLM nustatymo vadovas

Naudokite šį vadovą AI asistentų ir kalbos modelių konfigūravimui darbui su Lur.lv API. Žemiau pateiktoje užklausoje yra visa informacija, kurios reikia LLM suprasti ir teisingai naudoti API.

Kopijuoti LLM

Nukopijuokite šią užklausą ir įklijuokite į savo LLM (ChatGPT, Claude ir kt.), kad įgalintumėte naudoti Lur.lv API Latvijos įmonių paieškai.

# 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

Galutiniai taškai

GET

/companies/search

Ieškoti įmonių pagal pavadinimą, adresą arba registracijos numerį.

Parametrai:

q (privaloma) - Paieškos užklausa (min. 2 simboliai)
limit (neprivaloma) - Rezultatų skaičius (1-100, numatytasis: 20)
country (neprivaloma) - Filtruoti pagal šalies kodą (LV, LT)

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

GET

/companies/{regcode}

Gauti išsamią informaciją apie konkrečią įmonę, įskaitant sankcijų statusą.

Parametrai:

regcode (privaloma) - Įmonės registracijos numeris

Atsakymas apima:

Pagrindinė informacija (pavadinimas, adresas, teisinė forma)
Registracijos ir uždarymo datos
Mokesčių mokėtojo reitingas ir PVM statusas
NACE kodas ir aprašymas
Finansinės ataskaitos
Sankcijų statusas (isSanctioned: true/false)

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

GET

/companies/{regcode}/sanctions

Tikrinti, ar įmonė yra sankcijų sąraše, ir gauti detalią informaciją.

Parametrai:

regcode (privaloma) - Įmonės registracijos numeris

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

GET

/companies/autofill

Gaukite įmonės adreso ir PVM duomenis formų pildymui. Optimizuota laisvalaikio projektams.

Parametrai:

q (privaloma) - Įmonės pavadinimas arba kodas (min. 2 simboliai)
country (neprivaloma) - Filtruoti pagal šalies kodą (LV, LT)
limit (neprivaloma) - Maks. rezultatų (1-50, numatytasis: 10)

Atsakymas apima:

Įmonės kodas
Įmonės pavadinimas
Pilnas juridinis adresas
PVM kodas (jei registruota)
Šalies kodas (LV, LT ir kt.)

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

GET

/persons/check

Tikrinti, ar asmuo turi susijusių įmonių registracijų. Naudojama specifinių asmenų stebėsenai.

Parametrai:

name (privaloma) - Asmens vardas ir pavardė (min. 2 simboliai)
birthDate (privaloma) - Gimimo data ISO formatu (MMMM-MM-DD)
limit (neprivaloma) - Maks. įmonių asmeniui (1-100, numatytasis: 50)

Grąžina visus vaidmenis: tikrasis naudos gavėjas, vadovas, narys, akcininkas

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

GET

/persons/new-registrations

Gauti naujas asmens įmonių registracijas per paskutines N valandų. Naudojama specifinių asmenų stebėsenai per cron jobs.

Parametrai:

name (privaloma) - Asmens vardas ir pavardė (min. 2 simboliai)
birthDate (privaloma) - Gimimo data ISO formatu (MMMM-MM-DD)
hours (neprivaloma) - Laiko langas valandomis (1-168, numatytasis: 24)
limit (neprivaloma) - Maks. grąžinamų įmonių (1-1000, numatytasis: 100)

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

GET

/

API atradimo taškas, grąžinantis pilną dokumentaciją JSON formatu.

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

Techninė informacija

CORS

Visi taškai palaiko CORS su * kilme, leisdami tiesioginę prieigą iš naršyklės.

Kešavimas

Atsakymai saugomi talpykloje 30 minučių su 1 valandos 'stale-while-revalidate'. Antraštės: public, s-maxage=1800, stale-while-revalidate=3600

Užklausų limitai

Taikomi užklausų limitai siekiant išvengti piktnaudžiavimo. Įmonių taškai: 20 req/10s. Asmens patikra: 20 req/10s. Naujos registracijos: 10 req/60s.

Klaidų kodai

400 - Neteisinga užklausa (trūksta arba neteisingi parametrai)
404 - Įmonė nerasta
429 - Viršytas užklausų limitas
500 - Serverio klaida

LLM nustatymo vadovas

Naudokite šį vadovą AI asistentų ir kalbos modelių konfigūravimui darbui su Lur.lv API. Žemiau pateiktoje užklausoje yra visa informacija, kurios reikia LLM suprasti ir teisingai naudoti API.

Kopijuoti LLM

Nukopijuokite šią užklausą ir įklijuokite į savo LLM (ChatGPT, Claude ir kt.), kad įgalintumėte naudoti Lur.lv API Latvijos įmonių paieškai.

# 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