{"caching":{"cacheControl":"public, s-maxage=1800, stale-while-revalidate=3600","description":"Responses are cached for 30 minutes with 1 hour stale-while-revalidate"},"cors":{"allowMethods":["GET","OPTIONS"],"allowOrigin":"*","enabled":true},"description":"Public API for company, person-monitoring, and real-estate registry data","endpoints":{"/api/public/v1":{"description":"API discovery endpoint (this page)","method":"GET"},"/api/public/v1/companies/{regcode}":{"description":"Get detailed company information by registration number: registry identity, address, legal form, status, registration dates, VAT, tax rating, NACE, activities, officers, sanctions, compliance flags, insolvency/liquidation/reorganization proceedings, structural units, the 3 latest annual tax-payment years, and latest financial summary. For VAT, tax and sanctions status alone, the compliance lookup returns a smaller payload. Returns an {error} object when the registration code is unknown, or when countryCode is omitted and the code exists in more than one registry.","example":"https://datreal.com/api/public/v1/companies/40003009497?countryCode=LV","method":"GET","parameters":{"countryCode":{"description":"Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.","enum":["LV","LT","EE","FI","SE"],"required":false,"type":"string","example":"LV"},"regcode":{"description":"Company registration number","minLength":1,"required":true,"type":"string","example":""}},"response":{"description":"Company details including basic info, financial data, and sanctions status","fields":["regcode","name","address","legalForm","status","countryCode","registeredAt","closedAt","taxRating","financialReports","isSanctioned","sanctionSignals","vatNumber","naceCode","naceDescription","activities","compliance","officers","insolvencyProceedings","liquidations","reorganizations","farmLand","structuralUnits","taxPayments"]}},"/api/public/v1/companies/{regcode}/financials":{"description":"Get financial reports for up to the 12 latest available fiscal years: revenue, profit, assets, equity, employees, liabilities, cash flow, and more for each fiscal year. Returns an {error} object when the company has no filed reports, when the registration code is unknown, or when countryCode is omitted and the code exists in more than one registry.","example":"https://datreal.com/api/public/v1/companies/40003009497/financials?countryCode=LV","method":"GET","parameters":{"countryCode":{"description":"Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.","enum":["LV","LT","EE","FI","SE"],"required":false,"type":"string","example":"LV"},"regcode":{"description":"Company registration number","minLength":1,"required":true,"type":"string","example":""}},"response":{"description":"Financial reports for up to the 12 latest fiscal years; 404 when the company has no filed reports","fields":["regcode","reports","totalYears"]}},"/api/public/v1/companies/{regcode}/compliance":{"description":"Get a company's compliance snapshot: VAT number, status and registration dates, tax rating, tax debt amount, blacklist and other compliance flags, and sanctions signals with details. Use it when you need only compliance data; the company details lookup already includes these fields alongside the full registry profile. Returns an {error} object when the registration code is unknown, or when countryCode is omitted and the code exists in more than one registry.","example":"https://datreal.com/api/public/v1/companies/40003009497/compliance?countryCode=LV","method":"GET","parameters":{"countryCode":{"description":"Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.","enum":["LV","LT","EE","FI","SE"],"required":false,"type":"string","example":"LV"},"regcode":{"description":"Company registration number","minLength":1,"required":true,"type":"string","example":""}},"response":{"description":"VAT registration, tax rating, tax debt, compliance flags and sanctions signals","fields":["regcode","vatNumber","vatStatus","vatRegisteredAt","vatDeregisteredAt","taxRating","taxDebtAmount","hasTaxDebt","isBlacklisted","isSanctioned","sanctionSignals","sanctionsDetails","hasLateFinancialReports","hasMissingFinancialReports","hasMissingAuditReports","isMicroEnterpriseTaxpayer","isMinWageEmployer","isPublicBenefitOrg","isStateOwned","isSuspendedActivity"]}},"/api/public/v1/companies/{regcode}/shareholders":{"description":"Get available shareholders and beneficial owners (UBOs) of a company, including published names, ownership percentages, share counts and values, entity types, country, and related registration numbers where registries publish them.","example":"https://datreal.com/api/public/v1/companies/40003009497/shareholders?countryCode=LV","method":"GET","parameters":{"countryCode":{"description":"Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.","enum":["LV","LT","EE","FI","SE"],"required":false,"type":"string","example":"LV"},"regcode":{"description":"Company registration number","minLength":1,"required":true,"type":"string","example":""}},"response":{"description":"Available shareholders, beneficial owners, and counts","fields":["regcode","shareholders","beneficialOwners","totalShareholders","totalBeneficialOwners"]}},"/api/public/v1/companies/{regcode}/taxes":{"description":"Get year-by-year tax payments for the 3 most recent years with data (income tax, social tax, total tax, employees), newest first. The company details lookup includes the same rows. Returns an {error} object when the registration code is unknown, or when countryCode is omitted and the code exists in more than one registry. Change: the per-year headcount field is now `employees` (previously `employeeCount`).","example":"https://datreal.com/api/public/v1/companies/40003009497/taxes?countryCode=LV","method":"GET","parameters":{"countryCode":{"description":"Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.","enum":["LV","LT","EE","FI","SE"],"required":false,"type":"string","example":"LV"},"regcode":{"description":"Company registration number","minLength":1,"required":true,"type":"string","example":""}},"response":{"description":"Up to 3 most recent years of tax payments, ordered newest-first","fields":["regcode","taxPayments[].year","taxPayments[].totalTax","taxPayments[].incomeTax","taxPayments[].socialTax","taxPayments[].employees"]}},"/api/public/v1/companies/{regcode}/sanctions":{"description":"Check whether a company is on any sanctions list and return detailed sanctions hits (beneficial owners, entry dates, legal bases). Returns an {error} object when the registration code is unknown, or when countryCode is omitted and the code exists in more than one registry.","example":"https://datreal.com/api/public/v1/companies/40003009497/sanctions?countryCode=LV","method":"GET","parameters":{"countryCode":{"description":"Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.","enum":["LV","LT","EE","FI","SE"],"required":false,"type":"string","example":"LV"},"regcode":{"description":"Company registration number","minLength":1,"required":true,"type":"string","example":""}},"response":{"description":"Sanctions status and detailed information","fields":{"details":"Array of detailed sanctions information (beneficial owners, entry dates, legal bases)","isSanctioned":"Boolean indicating if company is sanctioned","regcode":"Registration code"}}},"/api/public/v1/companies/autofill":{"description":"Get company address and VAT data for form autofill. Optimized for address autocomplete in hobby projects.","example":"https://datreal.com/api/public/v1/companies/autofill?q=maxima&countryCode=LV&limit=5","method":"GET","parameters":{"countryCode":{"description":"Country code to filter results (LV, LT, EE, FI, SE)","example":"LV","required":false,"type":"string"},"limit":{"default":10,"description":"Maximum number of results to return","max":50,"min":1,"required":false,"type":"integer"},"q":{"description":"Company name or registration number (minimum 2 characters)","example":"maxima","required":true,"type":"string"}},"response":{"description":"Company autofill data optimized for address forms","fields":["regcode","name","address","vatNumber","countryCode"]}},"/api/public/v1/companies/search":{"description":"Search companies by name, address, or registration number across Baltic/Nordic countries (LV, LT, EE, FI, SE) and return basic registry data with latest-year financials.","example":"https://datreal.com/api/public/v1/companies/search?q=baltais&countryCode=LV&limit=10","method":"GET","parameters":{"countryCode":{"description":"Country code to filter results (LV, LT, EE, FI, SE).","enum":["LV","LT","EE","FI","SE"],"required":false,"type":"string","example":"LV"},"limit":{"description":"Maximum results (1-100)","max":100,"min":1,"required":false,"type":"integer","default":20},"nace":{"description":"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","required":false,"type":"string","example":"62"},"page":{"description":"Result page number. Deep pages are bounded to the search result window.","min":1,"required":false,"type":"integer","default":1},"q":{"description":"Search query (minimum 2 characters). Required unless nace is provided","minLength":2,"required":false,"type":"string","example":"baltais"}}},"/api/public/v1/real-estate/search":{"description":"Search real-estate cadastre data (LV, LT, EE, FI, SE) by address or cadastral/property identifier, with location, object-type, owner-type, municipality, business/listing/sale presence, area, cadastral value, sale price, built-year, and floor filters.","example":"https://datreal.com/api/public/v1/real-estate/search?municipality=Rīga&objectType=land&ownerType=legal_person&minBuiltYear=1900&countryCode=LV&limit=10","method":"GET","parameters":{"bbox":{"description":"Viewport bounding box as west,south,east,north in WGS84 degrees","required":false,"type":"string","example":"23.9,56.8,24.4,57.1"},"countryCode":{"description":"Country whose cadastre to search (LV, LT, EE, FI, SE). Omit to search all supported cadastres..","enum":["LV","LT","EE","FI","SE"],"required":false,"type":"string","example":"LV"},"hasBusiness":{"description":"Only objects linked to a business; use 1 to enable","required":false,"type":"string"},"hasListings":{"description":"Only objects with an active listing; use 1 to enable","required":false,"type":"string"},"hasSales":{"description":"Only objects with a recorded sale; use 1 to enable","required":false,"type":"string"},"maxArea":{"description":"Maximum land/building/premises area in m²","required":false,"type":"number"},"maxBuiltYear":{"description":"Maximum building/premises construction year","required":false,"type":"number"},"maxValue":{"description":"Maximum cadastral value in the object's local currency","required":false,"type":"number"},"maxFloors":{"description":"Maximum floors above ground","required":false,"type":"number"},"maxSalePrice":{"description":"Maximum recorded sale price in the transaction's local currency","required":false,"type":"number"},"minArea":{"description":"Minimum land/building/premises area in m²","required":false,"type":"number"},"minBuiltYear":{"description":"Minimum building/premises construction year","required":false,"type":"number"},"minValue":{"description":"Minimum cadastral value in the object's local currency","required":false,"type":"number"},"minFloors":{"description":"Minimum floors above ground","required":false,"type":"number"},"minSalePrice":{"description":"Minimum recorded sale price in the transaction's local currency","required":false,"type":"number"},"municipality":{"description":"Municipality name, or several comma-separated","required":false,"type":"string","example":"Rīga"},"objectType":{"description":"Property object type","enum":["land","building","premises"],"required":false,"type":"string"},"ownerType":{"description":"Effective owner classification (not owner identity)","enum":["natural_person","legal_person","mixed"],"required":false,"type":"string"},"limit":{"description":"Maximum number of results","max":100,"min":1,"required":false,"type":"integer","default":20},"page":{"description":"Result page number. Deep pages are bounded to the search result window.","min":1,"required":false,"type":"integer","default":1},"q":{"description":"Address text or cadastral/property identifier","minLength":2,"required":false,"type":"string"}}},"/api/public/v1/real-estate/{cadastralNumber}":{"description":"Get one real-estate object (LV, LT, EE, FI, SE) by cadastral/property identifier, country, and identifier scheme: cadastre facts, transaction history, and a comparable-sales value estimate where available.","example":"https://datreal.com/api/public/v1/real-estate/01000860398?countryCode=LV&scheme=LV_CADASTRAL_OBJECT","method":"GET","parameters":{"cadastralNumber":{"description":"Cadastral/property identifier","minLength":1,"required":true,"type":"string","example":""},"countryCode":{"description":"Country the identifier belongs to (LV, LT, EE, FI, SE). Required because identifiers are not globally unique across supported cadastres.","enum":["LV","LT","EE","FI","SE"],"required":true,"type":"string","example":"LV"},"scheme":{"description":"Identifier scheme returned by real-estate search (for example LV_CADASTRAL_OBJECT)","enum":["EE_CADASTRAL_UNIT","EE_EHR_BUILDING","EE_EHR_BUILDING_PART","EE_LAND_REGISTER_FOLIO","EE_STATE_ASSET","FI_BUILDING_PROJECT","FI_CADASTRAL_PARCEL","FI_CADASTRAL_PROPERTY","FI_PERMANENT_BUILDING_ID","LT_CADASTRAL_PARCEL","LT_UNIQUE_OBJECT","LV_CADASTRAL_OBJECT","LV_CADASTRAL_PROPERTY","SE_BUILDING","SE_CADASTRAL_AREA","SE_FASTIGHET"],"required":true,"type":"string","example":"LV_CADASTRAL_OBJECT"}}},"/api/public/v1/people/check":{"description":"Find the company roles (officer, beneficial owner, member, shareholder) linked to a person, matched by full name and birth date where public identifiers allow confident linking.","example":"Bērziņš&birthDate=1985-03-15&limit=50","method":"GET","parameters":{"birthDate":{"description":"Birth date in ISO format (YYYY-MM-DD)","required":true,"type":"string","example":"1985-03-15"},"limit":{"description":"Maximum number of companies to return per person","max":100,"min":1,"required":false,"type":"integer","default":50},"name":{"description":"Full name of the person (minimum 2 characters)","minLength":2,"required":true,"type":"string","example":"Jānis Bērziņš"}},"rateLimit":{"limit":20,"window":"10 seconds"},"response":{"description":"Matched person details with company roles where public identifiers allow confident matching","fields":{"companies":"Array of matched companies where the person has a linked role (officer, beneficial owner, member, shareholder, micro-enterprise)","count":"Number of matching persons","results":"Array of persons with their companies","success":"Boolean indicating if request was successful"}}},"/api/public/v1/people/new-registrations":{"description":"Get company roles newly linked to a person in the last N hours, matched by full name and birth date where public identifiers allow confident linking. Use it to monitor a known person for new companies.","example":"Bērziņš&birthDate=1985-03-15&hours=24&limit=100","method":"GET","parameters":{"birthDate":{"description":"Birth date in ISO format (YYYY-MM-DD)","required":true,"type":"string","example":"1985-03-15"},"hours":{"description":"Time window in hours to check for new registrations","max":168,"min":1,"required":false,"type":"integer","default":24},"limit":{"description":"Maximum number of companies to return","max":100,"min":1,"required":false,"type":"integer","default":100},"name":{"description":"Full name of the person (minimum 2 characters)","minLength":2,"required":true,"type":"string","example":"Jānis Bērziņš"}},"rateLimit":{"limit":10,"window":"60 seconds"},"response":{"description":"Newly linked company roles for the matched person in the requested time window","fields":{"count":"Number of matched people with new linked company roles","results":"Array with matched person records and their new linked company roles","success":"Boolean indicating if request was successful","timeWindowHours":"Time window used for the query"}}}},"notes":["All endpoints support CORS for browser-based access","Rate limiting is applied to prevent abuse (limits vary by endpoint)","Data is sourced from Baltic and Nordic (LV, LT, EE, FI, SE) business registries and sanctions databases","Person endpoints are identifier-backed and return matches where public person identifiers allow confident linking"],"version":"v1"}