DatReal

API dokumentācija

Publisks API uzņēmumu informācijai, sankciju pārbaudēm un personu uzraudzībai. Bezmaksas piekļuve Latvijas uzņēmumu reģistra datiem.

Ātrā sākšana

API ir pieejams bez reģistrācijas un autentifikācijas. Visi galapunkti atbalsta CORS, tāpēc tos var izmantot tieši no pārlūka.

Bāzes URL: https://datreal.com/api/public/v1

Galapunkti

GET

/companies/{regcode}

Iegūst detalizētu informāciju par konkrētu uzņēmumu, ieskaitot sankciju statusu.

Parametri:

  • regcode (obligāts) - Uzņēmuma reģistrācijas numurs

Atbilde ietver:

  • Pamatinformāciju (nosaukums, adrese, juridiskā forma)
  • Reģistrācijas un slēgšanas datumus
  • Nodokļu maksātāja reitingu un PVN statusu
  • NACE kodu un aprakstu
  • Finanšu pārskatus
  • Sankciju statusu (isSanctioned: true/false)
curl "https://datreal.com/api/public/v1/companies/40003245752"
GET

/companies/{regcode}/sanctions

Pārbauda, vai uzņēmums ir sankciju sarakstos, un atgriež detalizētu informāciju.

Parametri:

  • regcode (obligāts) - Uzņēmuma reģistrācijas numurs
curl "https://datreal.com/api/public/v1/companies/40003245752/sanctions"
GET

/persons/check

Pārbauda, vai konkrētai personai ir reģistrēti uzņēmumi. Izmanto konkrētu personu uzraudzībai.

Parametri:

  • name (obligāts) - Personas pilns vārds (min. 2 rakstzīmes)
  • birthDate (obligāts) - Dzimšanas datums ISO formātā (GGGG-MM-DD)
  • limit (neobligāts) - Maks. uzņēmumu skaits personai (1-100, noklusējums: 50)

Atgriež visas lomas: patiesais labuma guvējs, valdes loceklis, biedrs, akcionārs, mikrouzņēmums

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

/persons/new-registrations

Iegūst jaunas uzņēmumu reģistrācijas konkrētai personai pēdējās N stundās. Izmanto konkrētu personu uzraudzībai ar cron darbiem.

Parametri:

  • name (obligāts) - Personas pilns vārds (min. 2 rakstzīmes)
  • birthDate (obligāts) - Dzimšanas datums ISO formātā (GGGG-MM-DD)
  • hours (neobligāts) - Laika logs stundās (1-168, noklusējums: 24)
  • limit (neobligāts) - Maks. uzņēmumu skaits (1-1000, noklusējums: 100)
curl "https://datreal.com/api/public/v1/persons/new-registrations?name=Jānis%20Bērziņš&birthDate=1985-03-15&hours=24"
GET

/

API atklāšanas galapunkts, kas atgriež pilnu dokumentāciju JSON formātā.

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

Tehniskā informācija

CORS

Visi galapunkti atbalsta CORS ar * izcelsmi, ļaujot API izmantot tieši no pārlūka.

Kešošana

Atbildes tiek kešotas 30 minūtes ar 1 stundas stale-while-revalidate. Galvenes: public, s-maxage=1800, stale-while-revalidate=3600

Pieprasījumu ierobežojumi

Pieprasījumu ierobežojumi novērš ļaunprātīgu izmantošanu. Uzņēmumu galapunkti: 20 pieprasījumi/10s. Personu pārbaude: 20 pieprasījumi/10s. Jaunas reģistrācijas: 10 pieprasījumi/60s.

Kļūdu kodi

  • 400 - Nekorekts pieprasījums (trūkst parametru vai tie ir nederīgi)
  • 404 - Uzņēmums nav atrasts
  • 429 - Pieprasījumu ierobežojums pārsniegts
  • 500 - Servera kļūda

LLM iestatīšanas ceļvedis

Izmantojiet šo ceļvedi, lai konfigurētu AI asistentus un valodas modeļus darbam ar DatReal API. Zemāk esošais teksts satur visu informāciju, kas LLM nepieciešama, lai pareizi saprastu un izmantotu API.

Kopēt priekš LLM

Nokopējiet šo tekstu un ielīmējiet to savā LLM (ChatGPT, Claude u.c.), lai tas varētu izmantot DatReal API Latvijas uzņēmumu meklēšanai.

# DatReal API Integration Guide

You are integrating with the DatReal 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