Offentligt API för företagsinformation, sanktionskontroller, personövervakning och fastighetsuppslag i Lettland, Litauen, Estland, Finland och Sverige.
Snabbstart
API:et är tillgängligt utan registrering eller autentisering. Alla slutpunkter stöder CORS, så de kan användas direkt från webbläsaren.
- Bas-URL
https://datreal.com/api/public/v1
Exempel
curl "https://datreal.com/api/public/v1/companies/search?q=tallink&countryCode=EE&limit=5"Användningsfall
Slutpunkter grupperade efter användningsfall så att du kan välja rätt utan att läsa hela referensen.
Uppslag och sökning
Sök och hämta fullständiga företagsprofiler, automatisk komplettering av adress och grundläggande firmografik.
Ägande och personer
Aktieägare, verkliga huvudmän (UBO) och identifierbaserade matchningar mellan person och företag.
Efterlevnad
Sanktioner, svartlistor och skatteefterlevnadskontroller i LV, LT, EE, FI, SE.
Övervakning
Tidsfönsterbaserade förändringsflöden - nya registreringar och andra signaler nära realtid.
Fastigheter
Sök fastigheter i katastret och få objektinformation med registrerade försäljningar och värdeuppskattningar.
Endpoints
Uppslag och sökning
Sök och hämta fullständiga företagsprofiler, automatisk komplettering av adress och grundläggande firmografik.
GET /companies/search
/companies/searchSök företag efter namn, adress eller registreringsnummer.
Parametrar
countryCode(valfri)- Filtrera efter landskod (LV, LT, EE, FI, SE)
limit(valfri)- Antal resultat (1-100, standard: 20)
nace(valfri)- NACE-kodprefix (t.ex. J eller 62). Kan ersätta q.
page(valfri)- Resultatsida (börjar med 1). Senare sidor har ett begränsat sökfönster.
q(valfri)- Sökfråga (minst 2 tecken). Krävs om nace inte anges.
curl "https://datreal.com/api/public/v1/companies/search?q=tallink&countryCode=EE&limit=5"GET /companies/{regcode}
/companies/{regcode}Hämta detaljerad information om ett specifikt företag, inklusive sanktionsstatus.
Parametrar
countryCode(valfri)- Filtrera efter landskod (LV, LT, EE, FI, SE)
regcode(obligatorisk)- Företagets registreringsnummer
Svaret inkluderar
- Grundläggande information (namn, adress, juridisk form)
- Registrerings- och avslutningsdatum
- Skattebetalarbetyg och momsstatus
- NACE-kod och beskrivning
- Årsredovisningar
- Sanktionsstatus (IsSanctioned: true/false)
curl "https://datreal.com/api/public/v1/companies/40003245752?countryCode=LV"GET /companies/autofill
/companies/autofillHämta företagets adress- och momsuppgifter för automatisk ifyllning av formulär. Optimerad för automatisk komplettering av adress i hobbyprojekt.
Parametrar
countryCode(valfri)- Filtrera efter landskod (LV, LT, EE, FI, SE)
limit(valfri)- Max antal resultat (1-50, standard: 10)
q(obligatorisk)- Företagsnamn eller registreringsnummer (minst 2 tecken)
Svaret inkluderar
- Registreringsnummer (regkod)
- Företagsnamn
- Fullständig juridisk adress
- Momsnummer (om registrerat)
- Landskod (LV, LT, etc.)
curl "https://datreal.com/api/public/v1/companies/autofill?q=maxima&countryCode=LV&limit=5"GET /companies/{regcode}/financials
/companies/{regcode}/financialsHämta ett företags årliga finansiella rapporter. Returnerar 404 när inga rapporter finns.
Parametrar
countryCode(valfri)- Filtrera efter landskod (LV, LT, EE, FI, SE)
regcode(obligatorisk)- Företagets registreringsnummer
Svaret inkluderar
- reports - en post per räkenskapsår: intäkter, vinst, tillgångar, eget kapital, anställda, kassaflöde
- totalYears - antal returnerade räkenskapsår
curl "https://datreal.com/api/public/v1/companies/40003245752/financials?countryCode=LV"Ägande och personer
Aktieägare, verkliga huvudmän (UBO) och identifierbaserade matchningar mellan person och företag.
GET /people/check
/people/checkKontrollera matchade företagsroller för en person där offentliga identifierare möjliggör säker koppling.
Parametrar
birthDate(obligatorisk)- Födelsedatum i ISO-format (YYYY-MM-DD)
limit(valfri)- Max antal företag per person (1-100, standard: 50)
name(obligatorisk)- Personens fullständiga namn (minst 2 tecken)
Returnerar matchade roller där offentliga personidentifierare möjliggör säker koppling: verklig huvudman, befattningshavare, medlem, aktieägare, mikroföretag
curl "https://datreal.com/api/public/v1/people/check?name=Jānis%20Bērziņš&birthDate=1985-03-15"Efterlevnad
Sanktioner, svartlistor och skatteefterlevnadskontroller i LV, LT, EE, FI, SE.
GET /companies/{regcode}/compliance
/companies/{regcode}/complianceHämta momsregistrering, skattebetyg, skatteskuld och efterlevnadsflaggor i ett litet svar.
Parametrar
countryCode(valfri)- Filtrera efter landskod (LV, LT, EE, FI, SE)
regcode(obligatorisk)- Företagets registreringsnummer
Svaret inkluderar
- vatNumber / vatStatus / vatRegisteredAt - momsregistrering
- taxRating / taxDebtAmount / hasTaxDebt - skattestatus
- isBlacklisted / isSuspendedActivity / hasMissingFinancialReports och andra flaggor
- Sanktionsstatus (IsSanctioned: true/false)
curl "https://datreal.com/api/public/v1/companies/40003245752/compliance?countryCode=LV"GET /companies/{regcode}/taxes
/companies/{regcode}/taxesHämta företagets senaste årliga skattebetalningar, inklusive inkomstskatt, social skatt, total skatt och antal anställda.
Parametrar
countryCode(valfri)- Filtrera efter landskod (LV, LT, EE, FI, SE)
regcode(obligatorisk)- Företagets registreringsnummer
Svaret inkluderar
- taxPayments - upp till 3 senaste år med tillgängliga skattedata
- taxPayments[].totalTax / incomeTax / socialTax - årliga skattebetalningar
- taxPayments[].employees - rapporterat antal anställda för året
curl "https://datreal.com/api/public/v1/companies/40003245752/taxes?countryCode=LV"GET /companies/{regcode}/sanctions
/companies/{regcode}/sanctionsKontrollera om ett företag finns på sanktionslistan och få detaljerad information.
Parametrar
countryCode(valfri)- Filtrera efter landskod (LV, LT, EE, FI, SE)
regcode(obligatorisk)- Företagets registreringsnummer
curl "https://datreal.com/api/public/v1/companies/40003245752/sanctions?countryCode=LV"Övervakning
Tidsfönsterbaserade förändringsflöden - nya registreringar och andra signaler nära realtid.
GET /people/new-registrations
/people/new-registrationsHämta nyligen kopplade företagsroller för en matchad person under de senaste N timmarna. Används för identifierbaserad övervakning via cron-jobb.
Parametrar
birthDate(obligatorisk)- Födelsedatum i ISO-format (YYYY-MM-DD)
hours(valfri)- Tidsfönster i timmar (1-168, standard: 24)
limit(valfri)- Max antal företag att returnera (1-1000, standard: 100)
name(obligatorisk)- Personens fullständiga namn (minst 2 tecken)
curl "https://datreal.com/api/public/v1/people/new-registrations?name=Jānis%20Bērziņš&birthDate=1985-03-15&hours=24"Fastigheter
Sök fastigheter i katastret och få objektinformation med registrerade försäljningar och värdeuppskattningar.
GET /real-estate/search
/real-estate/searchSök fastigheter via adress eller fastighetsbeteckning med filter för typ, ägartyp, kommun, area, värde, byggår och våningar.
Parametrar
bbox(valfri)- Avgränsning: väst,syd,öst,nord i WGS84-grader
countryCode(valfri)- Land vars fastighetsregister ska sökas. Utelämna för att söka i alla stödda länder.
hasBusiness(valfri)- Endast objekt kopplade till företag; aktivera med 1
hasListings(valfri)- Endast objekt med aktiv annons; aktivera med 1
hasSales(valfri)- Endast objekt med registrerad försäljning; aktivera med 1
maxArea(valfri)- Högsta mark-/byggnads-/lokalyta i m²
maxBuiltYear(valfri)- Senaste byggår för byggnaden/lokalerna
maxValue(valfri)- Högsta taxeringsvärde i objektets lokala valuta
maxFloors(valfri)- Högsta antal våningar ovan mark
maxSalePrice(valfri)- Högsta registrerat försäljningspris i transaktionens lokala valuta
minArea(valfri)- Lägsta mark-/byggnads-/lokalyta i m²
minBuiltYear(valfri)- Tidigaste byggår för byggnaden/lokalerna
minValue(valfri)- Lägsta taxeringsvärde i objektets lokala valuta
minFloors(valfri)- Lägsta antal våningar ovan mark
minSalePrice(valfri)- Lägsta registrerat försäljningspris i transaktionens lokala valuta
municipality(valfri)- Kommunnamn eller flera namn åtskilda med kommatecken
objectType(valfri)- Fastighetsobjektets typ
ownerType(valfri)- Ägarklassificering, inte ägarens identitet
limit(valfri)- Högsta antal resultat (1–100, standard: 20)
page(valfri)- Resultatsida (börjar med 1). Senare sidor har ett begränsat sökfönster.
q(valfri)- Adresstext eller fastighets-/registeridentifierare
curl "https://datreal.com/api/public/v1/real-estate/search?q=Br%C4%ABv%C4%ABbas%20iela&countryCode=LV&objectType=building&ownerType=legal_person&minBuiltYear=1900&minFloors=2&limit=5"GET /real-estate/{cadastralNumber}
/real-estate/{cadastralNumber}Katasterfakta, registrerade försäljningar och värdeuppskattning baserad på jämförbara försäljningar.
Parametrar
cadastralNumber(obligatorisk)- Fastighets- eller registeridentifierare
countryCode(obligatorisk)- Land som identifieraren tillhör. Identifierare är inte globalt unika.
scheme(obligatorisk)- Identifierarsystem som returneras av fastighetssökningen
curl "https://datreal.com/api/public/v1/real-estate/01000302015?countryCode=LV&scheme=LV_CADASTRAL_OBJECT"API-upptäckt
Självbeskrivande rot som listar varje slutpunkt och dess parametrar.
GET /
/Slutpunkt för API-upptäckt som returnerar fullständig dokumentation i JSON-format.
curl "https://datreal.com/api/public/v1"Tekniska detaljer
- CORS
- Alla slutpunkter stöder CORS med
*ursprung, vilket möjliggör direkt webbläsaråtkomst till API:et. - Hastighetsgränser
- Hastighetsgränser tillämpas för att förhindra missbruk. Företagsslutpunkter: 20 förfrågningar/10 s. Fastighetsslutpunkter: 20 förfrågningar/10 s. Personkontroll: 20 förfrågningar/10 s. Nya registreringar: 10 förfrågningar/60 s.
- Felkoder
400- Ogiltig förfrågan (saknade eller ogiltiga parametrar)404- apiDocs.error404429- Hastighetsgräns överskriden500- apiDocs.error500
Installationsguide för LLM
Använd den här guiden för att konfigurera AI-assistenter och språkmodeller att fungera med Datreal.com API:et. Prompten nedan innehåller all information en LLM behöver för att förstå och använda API:et korrekt.
Kopiera för LLM
Kopiera den här prompten och klistra in den i din LLM (ChatGPT, Claude, etc.) för att göra det möjligt för den att använda Datreal.com API:et för uppslag av baltiska och nordiska företag.
# Datreal.com API Integration Guide
You are integrating with the Datreal.com public API for Baltic and Nordic (LV, LT, EE, FI, SE) company and real-estate data. Here is everything you need to know:
## Base URLhttps://datreal.com/api/public/v1
## AuthenticationNo authentication required. The API is publicly accessible.
## Available Endpoints
### 1. Search CompaniesGET /companies/search?q={query}&countryCode={countryCode}&limit={limit}&page={page}- countryCode (optional): Country code to filter results (LV, LT, EE, FI, SE).- limit (optional): Maximum results (1-100); minimum 1; maximum 100; default 20- nace (optional): Filter by NACE code prefix (section letter or numeric code, e.g. J or 62). Can be used without q to browse companies by activity- page (optional): Result page number. Deep pages are bounded to the search result window.; minimum 1; default 1- q (optional): Search query (minimum 2 characters). Required unless nace is provided- Returns: Paginated matching companies with regcode, name, address, status, page and pageSize
### 2. Address AutofillGET /companies/autofill?q={query}&countryCode={countryCode}&limit={limit}- q (required): Company name or registration number, minimum 2 characters- countryCode (optional): Country code to filter (LV, LT, EE, FI, SE)- limit (optional): Results count, 1-50, default 10- Returns: Slim company rows with address and VAT number for forms
### 3. Get Company DetailsGET /companies/{regcode}?countryCode={countryCode}- countryCode (optional): Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.- regcode (required): Company registration number- Returns: Full company details including financials, tax rating, VAT status, sanctions status
### 4. Get Company FinancialsGET /companies/{regcode}/financials?countryCode={countryCode}- countryCode (optional): Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.- regcode (required): Company registration number- Returns: Yearly financial reports with revenue, profit, assets, equity and employees, plus totalYears
### 5. Get Shareholders & Beneficial OwnersGET /companies/{regcode}/shareholders?countryCode={countryCode}- countryCode (optional): Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.- regcode (required): Company registration number- Returns: available shareholders[], beneficialOwners[], totalShareholders, totalBeneficialOwners where registries publish ownership data
### 6. Get Company ComplianceGET /companies/{regcode}/compliance?countryCode={countryCode}- countryCode (optional): Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.- regcode (required): Company registration number- Returns: VAT registration, tax rating, tax debt, sanctions signals and compliance flags
### 7. Get Company TaxesGET /companies/{regcode}/taxes?countryCode={countryCode}- countryCode (optional): Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.- regcode (required): Company registration number- Returns: Up to 3 recent yearly tax payment rows with totalTax, incomeTax, socialTax, and employees
### 8. Check SanctionsGET /companies/{regcode}/sanctions?countryCode={countryCode}- countryCode (optional): Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.- regcode (required): Company registration number- Returns: Sanctions status and list of any active sanctions
### 9. Check PersonGET /people/check?name={name}&birthDate={birthDate}&limit={limit}- birthDate (required): Birth date in ISO format (YYYY-MM-DD)- limit (optional): Maximum number of companies to return per person; minimum 1; maximum 100; default 50- name (required): Full name of the person (minimum 2 characters)- Returns: Matched company roles where public person identifiers allow confident linking (board member, shareholder, beneficial owner, etc.)
### 10. New RegistrationsGET /people/new-registrations?name={name}&birthDate={birthDate}&hours={hours}&limit={limit}- birthDate (required): Birth date in ISO format (YYYY-MM-DD)- hours (optional): Time window in hours to check for new registrations; minimum 1; maximum 168; default 24- limit (optional): Maximum number of companies to return; minimum 1; maximum 100; default 100- name (required): Full name of the person (minimum 2 characters)- Returns: Newly linked company roles for matched people within the time window
### 11. Search Real EstateGET /real-estate/search?q={query}&countryCode={countryCode}&bbox={bbox}&hasBusiness={hasBusiness}&hasListings={hasListings}&hasSales={hasSales}&maxArea={maxArea}&maxBuiltYear={maxBuiltYear}&maxValue={maxValue}&maxFloors={maxFloors}&maxSalePrice={maxSalePrice}&minArea={minArea}&minBuiltYear={minBuiltYear}&minValue={minValue}&minFloors={minFloors}&minSalePrice={minSalePrice}&municipality={municipality}&objectType={objectType}&ownerType={ownerType}&limit={limit}&page={page}- bbox (optional): Viewport bounding box as west,south,east,north in WGS84 degrees- countryCode (optional): Country whose cadastre to search (LV, LT, EE, FI, SE). Omit to search all supported cadastres..- hasBusiness (optional): Only objects linked to a business; use 1 to enable- hasListings (optional): Only objects with an active listing; use 1 to enable- hasSales (optional): Only objects with a recorded sale; use 1 to enable- maxArea (optional): Maximum land/building/premises area in m²- maxBuiltYear (optional): Maximum building/premises construction year- maxValue (optional): Maximum cadastral value in the object's local currency- maxFloors (optional): Maximum floors above ground- maxSalePrice (optional): Maximum recorded sale price in the transaction's local currency- minArea (optional): Minimum land/building/premises area in m²- minBuiltYear (optional): Minimum building/premises construction year- minValue (optional): Minimum cadastral value in the object's local currency- minFloors (optional): Minimum floors above ground- minSalePrice (optional): Minimum recorded sale price in the transaction's local currency- municipality (optional): Municipality name, or several comma-separated- objectType (optional): Property object type- ownerType (optional): Effective owner classification (not owner identity)- limit (optional): Maximum number of results; minimum 1; maximum 100; default 20- page (optional): Result page number. Deep pages are bounded to the search result window.; minimum 1; default 1- q (optional): Address text or cadastral/property identifier- Returns: Matching cadastre objects with address, municipality, area, value, and coordinates
### 12. Get Property DetailsGET /real-estate/{cadastralNumber}?countryCode={countryCode}&scheme={identifierScheme}- cadastralNumber (required): Cadastral/property identifier- countryCode (required): Country the identifier belongs to (LV, LT, EE, FI, SE). Required because identifiers are not globally unique across supported cadastres.- scheme (required): Identifier scheme returned by real-estate search (for example LV_CADASTRAL_OBJECT)- Returns: Cadastre facts, matched transaction history, and value estimate where available
## Rate Limits- Company endpoints: 20 requests per 10 seconds- Real-estate endpoints: 20 requests per 10 seconds- Person check: 20 requests per 10 seconds- New registrations: 10 requests per 60 seconds
## Response FormatAll 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
## CORSAll endpoints support CORS with * origin, allowing direct browser access.
## CachingResponses are cached for 30 minutes with stale-while-revalidate of 1 hour.
## Example UsageTo search for a company: GET https://datreal.com/api/public/v1/companies/search?q=example&limit=10To get company details: GET https://datreal.com/api/public/v1/companies/40003245752?countryCode=LVTo check sanctions: GET https://datreal.com/api/public/v1/companies/40003245752/sanctions?countryCode=LVTo search real estate: GET https://datreal.com/api/public/v1/real-estate/search?countryCode=LV&municipality=Rīga&objectType=land&ownerType=legal_person&minBuiltYear=1900MCP-server
Anslut Claude Desktop, Claude Code eller valfri MCP-kompatibel AI-klient direkt till våra företagsdata med hjälp av Model Context Protocol (MCP). Inga API-nycklar behövs.
Installation för Claude Code
Kör det här kommandot i din terminal för att lägga till MCP-servern i Claude Code:
claude mcp add datreal --transport http https://datreal.com/api/mcpInstallation för Claude Desktop
Lägg till följande i din konfigurationsfil för Claude Desktop:
{ "mcpServers": { "datreal": { "type": "url", "url": "https://datreal.com/api/mcp" } }}- macOS
~/Library/Application Support/Claude/claude_desktop_config.json- Windows
%APPDATA%\Claude\claude_desktop_config.json
Slutpunkt för MCP-server
- Server-URL (Streamable HTTP)
https://datreal.com/api/mcp
Tillgängliga verktyg
search_companies- Sök företag efter namn, adress eller registreringsnummer i LV, LT, EE, FI, SE.
get_company_details- Hämta fullständig företagsinformation: namn, adress, juridisk form, moms, skattebetyg, NACE-kod, sanktioner, befattningshavare, verksamheter, insolvens- och likvidationsförfaranden, arbetsställen, skattebetalningar för de 3 senaste åren och senaste ekonomi.
get_company_financials- Hämta finansiella rapporter över flera år: intäkter, vinst, tillgångar, eget kapital, anställda, skulder och kassaflöde.
get_shareholders- Publicerade aktieägare och verkliga huvudmän (UBO) med ägarandelar, antal aktier och motpartens registreringskoder.
get_company_compliance- Hämta momsnummer, skattebetyg, sanktionsstatus, skatteskuld, svartlistningsstatus och alla efterlevnadsflaggor.
search_real_estate- Sök fastigheter via adress eller fastighetsbeteckning med filter för typ, ägartyp, kommun, area, värde, byggår och våningar.
get_real_estate_details- Katasterfakta, registrerade försäljningar och värdeuppskattning baserad på jämförbara försäljningar.
check_company_sanctions- Kontrollera om ett företag finns på en sanktionslista och hämta matchande poster.
get_company_taxes- Hämta skattebetalningar per år: inkomstskatt, sociala avgifter, totalt och anställda.
check_person- Hitta en persons företagsroller efter fullständigt namn och födelsedatum.
get_person_new_registrations- Hämta en persons företagsroller som länkats de senaste N timmarna, för bevakning.
Exempel på användning
När du är ansluten kan du ställa frågor till Claude som:
- "Vad är intäkterna för SIA Maxima Latvija?"
- "Visa mig den finansiella historiken för företag 40003245752"
- "Är detta företag sanktionerat? Kontrollera regkod 40003245752"
- "Hitta estniska företag som heter Bolt"