{"components":{"schemas":{"AuxiliaryCompanyName":{"description":"Auxiliary company name","properties":{"auxiliaryCompanyName":{"description":"Auxiliary company name","type":"string"},"auxiliaryCompanyRegistrationDate":{"description":"Date of registration of the auxiliary company name","type":"string"},"translationsOfTheAuxiliaryCompanyName":{"description":"Translations of the auxiliary company name","items":{"$ref":"#/components/schemas/TranslationOfTheAuxiliaryCompanyName"},"type":"array"}},"type":"object"},"BadRequest":{"description":"Returned when something is wrong in the request, e.g. failed argument validation or missed argument","properties":{"attributes":{"description":"Invalid attributes","items":{"$ref":"#/components/schemas/RequestAttribute"},"type":"array"},"error":{"default":"BadRequest","description":"Error name","type":"string"},"message":{"default":"Required arguments are missing in the request","description":"Description of the request error","type":"string"}},"type":"object"},"MultiCompaniesOverviewsResult":{"description":"Multiple companies overviews result","properties":{"records":{"description":"found overview(s)","items":{"$ref":"#/components/schemas/Overview"},"type":"array"},"responseInfo":{"$ref":"#/components/schemas/ResponseInfo"},"status":{"$ref":"#/components/schemas/SearchResultStatus"}},"type":"object"},"MultiCompanyRequest":{"description":"Multiple companies ids request","properties":{"companyIds":{"description":"array of company id","items":{"description":"array of company id","type":"string"},"type":"array"},"requestKey":{"description":"cache key for companies id-s in sandbox","type":"string"}},"type":"object"},"Overview":{"description":"Company Overview","properties":{"auxiliaryCompanyNames":{"description":"Auxiliary company name (there may be several)","items":{"$ref":"#/components/schemas/AuxiliaryCompanyName"},"type":"array"},"changeDate":{"description":"Date for the latest change (Date in ISO 8601 standard)","type":"string"},"companyId":{"description":"National identifier for the company","type":"string"},"companyName":{"description":"Company name","type":"string"},"companyNameRegistrationDate":{"description":"Date of registration company name","type":"string"},"companyRegistrationDate":{"description":"Date of entry of business into the Trade Register (first registration)","type":"string"},"contactInformationRegistrationDate":{"description":"Contact details submitted by the business; date when the details were changed ","type":"string"},"dissolutionDate":{"description":"Dissolution date","type":"string"},"dissolutionMode":{"description":"Dissolution mode","type":"string"},"domicileCode":{"description":"Registered office (domicile) as a code; text is shown if there is no code available for the registered office","type":"string"},"domicileRegistrationDate":{"description":"Office registration date","type":"string"},"domicileText":{"description":"Registered office as a text","type":"string"},"email":{"description":"Email ","type":"string"},"faxNumber":{"description":"Fax","type":"string"},"industryCode":{"description":"Industry code","type":"string"},"industryText":{"description":"Industry code description","type":"string"},"informationCheckedDate":{"description":"Date when the business details were transferred to the register system ","type":"string"},"languageCode":{"description":"The language the business has used for registering their information (as a code)","type":"string"},"latestRegistrationDate":{"description":"Latest date of registration (date when the most recent detail or change was registered for the business or organisation)","type":"string"},"legalGroupCode":{"description":"Type of business, as a code ","type":"string"},"legalGroupText":{"description":"Type of business, as a text","type":"string"},"legalGroupregistrationDate":{"description":"Date of legal group code registration","type":"string"},"parallelCompanyNames":{"description":"A translation of the company name (there may be several parallel company names); language of the translation; and date of registration of the name","items":{"$ref":"#/components/schemas/ParallelCompanyName"},"type":"array"},"parallelIndustryTexts":{"description":"Translations of industry code description","items":{"$ref":"#/components/schemas/Translation"},"type":"array"},"parallelLegalGroupTexts":{"description":"Translations of type of business text","items":{"$ref":"#/components/schemas/Translation"},"type":"array"},"parallelTopDirectorFunctions":{"description":"Translations of top director role","items":{"$ref":"#/components/schemas/Translation"},"type":"array"},"phoneNumber":{"description":"Telephone","type":"string"},"postAddress":{"description":"Street address","type":"string"},"postCoAddress":{"description":"Co specifier","type":"string"},"postCountry":{"description":"Country","type":"string"},"postTown":{"description":"Town/city","type":"string"},"postZipCode":{"description":"Postal code","type":"string"},"registers":{"description":"Registers information","items":{"$ref":"#/components/schemas/Register"},"type":"array"},"statusCode":{"description":"Company situation","type":"string"},"statusRegistrationDate":{"description":"Date of registration","type":"string"},"statusStartDate":{"description":"Start date of proceedings","type":"string"},"topDirectorFunction":{"description":"Top director role","type":"string"},"topDirectorName":{"description":"Name of top director","type":"string"},"visitAddress":{"description":"Street address","type":"string"},"visitCoAddress":{"description":"Co specifier","type":"string"},"visitCountry":{"description":"Country","type":"string"},"visitTown":{"description":"Town/city","type":"string"},"visitZipCode":{"description":"Postal code","type":"string"},"webAddress":{"description":"Web address, home page address ","type":"string"}},"type":"object"},"OverviewsResult":{"description":"Company(s) overview(s) result","properties":{"records":{"description":"found overview(s)","items":{"$ref":"#/components/schemas/Overview"},"type":"array"},"status":{"$ref":"#/components/schemas/SearchResultStatus"}},"type":"object"},"ParallelCompanyName":{"description":"Parallel company name","properties":{"parallelCompanyLanguage":{"description":"Language of the translation","type":"string"},"parallelCompanyName":{"description":"A translation of the company name","type":"string"},"parallelCompanyRegistrationDate":{"description":"Date of registration of the name","type":"string"}},"type":"object"},"Register":{"description":"Information about registered register","properties":{"parallelRegisterNames":{"description":"Translations of register name","items":{"$ref":"#/components/schemas/Translation"},"type":"array"},"parallelStatuses":{"description":"Translations of status","items":{"$ref":"#/components/schemas/Translation"},"type":"array"},"registerName":{"description":"Register name","type":"string"},"registrationDate":{"description":"Date of registration","type":"string"},"status":{"description":"Status of being in the register","type":"string"}},"type":"object"},"RequestAttribute":{"description":"Incorrect attribute of request","properties":{"attribute":{"description":"Parameter name","type":"string"},"value":{"description":"Parameter value, subject for validation","type":"string"}},"type":"object"},"ResponseInfo":{"description":"Multiple response information","properties":{"hitCount":{"description":"Number of companyIds in response (companyIds that could be found)","format":"int32","type":"integer"},"noMatchIds":{"description":"Array of companyIds that was in request but could not be matched","items":{"description":"Array of companyIds that was in request but could not be matched","type":"string"},"type":"array"},"requestCount":{"description":"Number of requested companyIds","format":"int32","type":"integer"}},"type":"object"},"SearchResultStatus":{"description":"Description of search result","properties":{"code":{"description":"0 - found, 1 - not found","format":"int32","type":"integer"},"text":{"description":"search result description","type":"string"}},"type":"object"},"ServerError":{"description":"Internal server error","properties":{"error":{"default":"InternalServerError","description":"Error name","type":"string"},"message":{"default":"An internal server error occurred, please contact the system administrator with information on the error","description":"Description of the request error","type":"string"}},"type":"object"},"Translation":{"description":"Translation of text","properties":{"langCode":{"description":"Translation language iso code","type":"string"},"text":{"description":"Translation text","type":"string"}},"type":"object"},"TranslationOfTheAuxiliaryCompanyName":{"description":"Translation of the auxiliary company name","properties":{"translationOfTheAuxiliaryCompanyLanguage":{"description":"Language of translation","type":"string"},"translationOfTheAuxiliaryCompanyName":{"description":"Translation of the auxiliary company name","type":"string"},"translationOfTheAuxiliaryCompanyRegistrationDate":{"description":"Date of registration of translation","type":"string"}},"type":"object"}},"securitySchemes":{"OAuth2":{"flows":{"clientCredentials":{"scopes":{},"tokenUrl":"https://api.roaring.io/token"}},"type":"oauth2"}}},"info":{"description":"Fetch company/companies overview(s)\nVerify and Monitor Company Information with Company Information API\nThe Company Information API provides crucial insights into a business’s identity, structure, and status. This data helps create smooth customer journeys, make secure, informed decisions, and reduce exposure to risks.\n\nThe API offers:\n\n**Current and historical company data, including:**\n\n- Company name and address\n- Status and industry\n- Top-executive\n\n**Historical data that tracks changes over time, such as:**\n\n- Address updates\n\n**Use case:**\nA financial institution onboarding a new B2B customer uses the Company Information API to check the company’s address and leadership history, ensuring that they understand any shifts in the company’s structure and potential risks before finalizing a business relationship.\n\n\n# Data source information\nWhen using data from this service you are required to inform users that the underlying data source is the Finnish patent and registration office (PRH).\n\n# Finnish Industry Codes\nFrom 1st January 2026, Finnish industry codes use the standard TOL2025. \nThe change affects all active companies.\nTOL 2025 follows European NACE Rev 2.1 for 1-4 digit level. The 5th digit is specific for Finland. See: [Statistics Finland](https://stat.fi/en/luokitukset/toimiala/toimiala_1_20250101) \n\nBefore 1st January 2026, the standard used was TOL2008 (SIC2008).\n\n\n# Finnish Legal Group Codes\nBelow is a list of available Legal Group codes for a company. The information is displayed as a code with a descriptive text. \n\n| Code | Description (English) | Description (Swedish) | Description (Finnish)\n| --- | --- | --- | --- |\nAHVE | Province of Åland and its departments | Landskapet Åland och dess ämbetsverk | Ahvenanmaan maakunta ja sen virastot\nAOY | Housing company | Bostadsaktiebolag | Asunto-osakeyhtiö\nASH | Resident-administered area | Boendeförvaltningsområde | Asukashallintoalue\nASY | Right-of-occupancy association | Bostadsrättsförening | Asumisoikeusyhdistys\nAY | Partnership | Öppet bolag | Avoin yhtiö\nAYH | Non-profit association | Ideell förening | Aatteellinen yhdistys\nESÄÄ | Company pension fund | Pensionsstiftelse | Eläkesäätiö\nETS | Finnish branch of a European economic interest grouping | EEIGs driftställe i Finland | ETEY:n sivuliike Suomessa\nETY | European economic interest grouping | Europeisk ekonomisk intressegruppering | Eurooppalainen taloudellinen etuyhtymä\nEVL | Government business with separate administration | Statlig inrättning med separat förvaltning | Erillishallinnollinen valtion laitos\nEVLUT | Lutheran Church | Ev.luth. kyrkan | Ev.lut.kirkko\nEYHT | Business partnership | Näringssammanslutning | Elinkeinoyhtymä\nHY | Mortgage society | Hypoteksförening | Hypoteekkiyhdistys\nKK | Chamber of commerce | Handelskammare | Kauppakamari\nKKOY | Limited liability joint-stock property company | Ömsesidigt fastighetsaktiebolag | Keskinäinen kiinteistöosakeyhtiö\nKONK | Bankrupt´s estate | Konkursbo | Konkurssipesä\nKP | Death estate | Dödsbo | Kuolinpesä\nKUNT | Municipality | Kommun | Kunta\nKUNTLL | Municipal business | Kommunal affärsinrättning | Kunnallinen liikelaitos\nKUNTLLL | Joint municipal business | Kommunförbundets affärsinrättning | Kuntainliiton liikelaitos\nKUNTYHT | Joint municipal authority | Samkommun | Kuntayhtymä\nKVAKYH | Mutual non-life insurance society | Ömsesidigt skadeförsäkringsförening | Keskinäinen vahinkovak.yhdistys\nKVJ | Public mutual insurance company | Publikt ömsesidigt försäkringsbolag | Julkinen keskinäinen vakuutusyhtiö\nKVY | Mutual insurance company | Ömsesidigt försäkringsbolag | Keskinäinen vakuutusyhtiö\nKY | Limited partnership | Kommanditbolag | Kommandiittiyhtiö\nLIY | Shipping company | Rederibolag | Laivanisännistöyhtiö\nLYH-PALISKUNTA | Partnership for reindeer herding | Renbeteslag | Paliskunta\nMAAKUNT | Province | Landskap | Maakunta\nMHY | Forest management association | Skogsvårdsförening | Metsänhoitoyhdistys\nMJUO | Other juridical person under public law | Annan offentligrättslig juridisk person | Muu julkisoikeudellinen oikeushenkilö\nMOHLÖ | Other juridical persons | Övriga juridiska personer | Muut oikeushenkilöt\nMSÄÄ | Other foundation | Annan stiftelse | Muu säätiö\nMTYH | Other economic association | Annan ekonomisk förening | Muu taloudellinen yhdistys\nMUU | Other company | Annat bolag | Muu yhtiö\nMUUKOY | Other real estate limited company | Annat fastighetsaktiebolag | Muu kiinteistöosakeyhtiö\nMUVE | Other taxable unit | Annan enhet inom beskattningen | Muu verotuksen yksikkö\nMUYP | Other subject with joint liability to tax withholding | Annan solidariskt ansvarig innehållningspliktig | Muu yhteisvast.pidätysvelvollinen\nMYH | Other association | Annan förening | Muu yhdistys\nOK | Co-operative | Andelslag | Osuuskunta\nOP | Co-operative bank | Andelsbank | Osuuspankki\nORTO | Orthodox Church | Ortodoxa kyrkan | Ortodoksinen kirkko\nOY | Limited company | Aktiebolag | Osakeyhtiö\nOYJ | Public limited company | Publikt aktiebolag | Julkinen osakeyhtiö\nRUSY | Religious community | Religionssamfund | Uskonnollinen yhdyskunta\nSÄÄ | Foundation | Stiftelse | Säätiö\nSCE | European co-operative society | Europaandelslag | Eurooppaosuuskunta\nSCP | European co-operative bank | Europaandelsbank | Eurooppaosuuspankki\nSE | European company | Europabolag | Eurooppayhtiö\nSEK | Mutual European insurance company | Ömsesidigt europaförsäkringsbolag | Keskinäinen eurooppavakuutusyhtiö\nSEV | European limited insurance company | Europaförsäkringsaktiebolag | Eurooppavakuutusosakeyhtiö\nSL | Branch of a foreign trader | Utländsk näringsidkares filial | Ulkomaisen elinkeinonharjoittajan sivuliike\nSP | Savings bank | Sparbank | Säästöpankki\nTEKA | Industry-wide pension fund | Arbetspensionskassa | Työeläkekassa\nTYH | Association for carrying on economic activity | Ekonomisk förening | Taloudellinen yhdistys\nTYKA | Unemployment fund | Arbetslöshetskassa | Työttömyyskassa\nULKO | Foreign organisation | Utländskt samfund | Ulkomainen yhteisö\nUS | Local community | Lokalsamfund | Paikallisyhteisö\nVAKK | Insurance fund | Försäkringskassa | Vakuutuskassa\nVALT | Government and its bureaus | Staten och dess inrättningar | Valtio ja sen laitokset\nVALTLL | Public business | Statlig affärsinrättning | Valtion liikelaitos\nVEYHT | Taxable grouping | Beskattningssammanslutning | Verotusyhtymä\nVLL | State-owned company | Statens affärsverk | Valtion liikelaitos\nVOJ | Public limited insurance company | Publikt försäkringsaktiebolag | Julkinen vakuutusosakeyhtiö\nVOY | Limited insurance company | Försäkringsaktiebolag | Vakuutusosakeyhtiö\nVY | Insurance association | Försäkringsförening | Vakuutusyhdistys\nYEH | Private trader | Enskild näringsidkare | Yksityinen elinkeinonharjoittaja\nYHME | Collective forest | Samfälld skog | Yhteismetsä\nYHTE | Joint interest groups | Samfällda förmåner | Yhteisetuudet\nYO | Student union or student club | Studentkår eller studentnation | Ylioppilaskunta tai osakunta\n\n# Dissolution Mode Codes\nBelow is a list of possible reasons of dissolution from the Finnish Trade Register.\n\nCode|Description English |Description Swedish|Description Finnish\n --- | --- | --- | ---\nFU|Merger|Fusion|Fuusio\nJA|Demerger|Delning|Jakautuminen\nJY|Continuing business as a private trader|Verksamhet fortsätts av en enskild näringsidkare|Jatkaminen yksityisenä elinkeinonharjoittajana\nKO|Bankruptcy|Konkurs|Konkurssi\nKOP|Removal from the register|Avregistrering|Poisto\nLA|Dissolved|Upplösts|Lakannut\nLUP|Conversion into a foundation|Ombildning till stiftelse|Muutos säätiöksi\nPA|Removal from the register (Housing Company Act)|Avregistrering (lag om bostadsaktiebolag)|Poisto (asunto-osakeyhtiölaki)\nPK|Removal from the register (Co-operatives Act)|Avregistrering (lag om andelslag)|Poisto (osuuskuntalaki)\nPO|Removal from the register (Trade Register Act)|Avregistrering (handelsregisterlag)|Poisto (kaupparekisterilaki)\nPOIS|Removal from the register|Avregistrering|Poisto\nPOT|Removal on the basis of the financial statements|Avreg. pga bokslut|Tilinpäätöspoisto\nPP|Removal from the register (Limited Liability Companies Act)|Avregistrering (aktiebolagslag)|Poisto (osakeyhtiölaki)\nPT|Removal from the register (court order)|Avregistrering (domstolsförordnande)|Poisto (tuomioistuinmääräys)\nSE|Liquidation|Likvidation|Selvitystila\nSEP|Removal from the register|Avregistrering|Poisto\nSI|Change of domicile or registered office|Flyttning av hemort|Kotipaikan siirto\n\n\n# Status codes\nBelow is a list of available status codes for a company.\n\n| Status Code | Status Text | \n| --- | --- |\n| KON | Bankrupt |\n| VEL | On the debt reorganization |\n| SAN | Restructuring proceedings |\n| SEL | In liquidation |\n| KES | Activity interrupted |\n\n","title":"Company Information","version":"1.0","x-logo":{"url":"https://assets.roaring.io/svg/company-overview-v3.1.svg"}},"openapi":"3.0.1","paths":{"/{companyId}":{"get":{"description":"It supports date parameter to find overview up to date\n\n### Sandbox examples\nIn order to test the service, please use the following values in the Sandbox environment:\n\n| Description | URL |\n| - | - |\n| Limited company | [/fi/company/overview/1.0/2292844-0](#L2ZpL2NvbXBhbnkvb3ZlcnZpZXcvMS4wLzIyOTI4NDQtMA==) |\n| Sole trader | [/fi/company/overview/1.0/2389097-4](#L2ZpL2NvbXBhbnkvb3ZlcnZpZXcvMS4wLzIzODkwOTctNA==) |\n| Company | [/fi/company/overview/1.0/1737785-9](#L2ZpL2NvbXBhbnkvb3ZlcnZpZXcvMS4wLzE3Mzc3ODUtOQ==) |\n| Legal representation activities (YEH) | [/fi/company/overview/1.0/1700009-0](#L2ZpL2NvbXBhbnkvb3ZlcnZpZXcvMS4wLzE3MDAwMDktMA==) |\n| Company A  | [/fi/company/overview/1.0/2149172-6](#L2ZpL2NvbXBhbnkvb3ZlcnZpZXcvMS4wLzIxNDkxNzItNg==) |\n| Limited company | [/fi/company/overview/1.0/0100582-3](#L2ZpL2NvbXBhbnkvb3ZlcnZpZXcvMS4wLzAxMDA1ODItMw==) |\n| Company P Private Trader | [/fi/company/overview/1.0/2202757-0](#L2ZpL2NvbXBhbnkvb3ZlcnZpZXcvMS4wLzIyMDI3NTctMA==) |\n| Company B | [/fi/company/overview/1.0/0687569-2](#L2ZpL2NvbXBhbnkvb3ZlcnZpZXcvMS4wLzA2ODc1NjktMg==) |\n| Company K - Ceased (Status Code: KON) | [/fi/company/overview/1.0/0106262-5](#L2ZpL2NvbXBhbnkvb3ZlcnZpZXcvMS4wLzAxMDYyNjItNQ==) |\n| Company C private trader | [/fi/company/overview/1.0/1182436-3](#L2ZpL2NvbXBhbnkvb3ZlcnZpZXcvMS4wLzExODI0MzYtMw==) |\n| Test Company Education Oy | [/fi/company/overview/1.0/2576102-5](#L2ZpL2NvbXBhbnkvb3ZlcnZpZXcvMS4wLzI1NzYxMDItNQ==) |\n","operationId":"view","parameters":[{"description":"id of company","in":"path","name":"companyId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OverviewsResult"}}},"description":"OK, successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}},"description":"Returned when something is wrong in the request, e.g. failed argument validation or arguments are missing"},"404":{"description":"Requested resource could not be found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServerError"}}},"description":"An internal server error occurred, please contact the system administrator with information on the error"}},"summary":"Find overview by company id","tags":["OverviewFi"],"x-code-samples":[{"lang":"Shell","source":"curl -X GET --header 'Accept: application/json'\\\n--header 'Authorization: Bearer {ACCESS TOKEN}'\\\n'https://api.roaring.io/fi/company/overview/1.0/{companyId}'"}]}},"/history/{companyId}":{"get":{"description":"Changes of the company within specified date range. The range includes \"from\" and excludes \"to\".","operationId":"history","parameters":[{"description":"id of company","in":"path","name":"companyId","required":true,"schema":{"type":"string"}},{"description":"beginning of the date range (including), iso 8601 format","in":"query","name":"fromDate","schema":{"type":"string"}},{"description":"ending of the date range (excluding), iso 8601 format","in":"query","name":"toDate","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OverviewsResult"}}},"description":"OK, successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}},"description":"Returned when something is wrong in the request, e.g. failed argument validation or arguments are missing"},"404":{"description":"Requested resource could not be found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServerError"}}},"description":"An internal server error occurred, please contact the system administrator with information on the error"}},"summary":"Find history overview by company id","tags":["OverviewFi"],"x-code-samples":[{"lang":"Shell","source":"curl -X GET --header 'Accept: application/json'\\\n--header 'Authorization: Bearer {ACCESS TOKEN}'\\\n'https://api.roaring.io/fi/company/overview/1.0/history/{companyId}'"}]}},"/":{"post":{"description":"It supports date parameter to find overviews up to date","operationId":"getCompanyOverviewList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultiCompanyRequest"}}},"description":"request body with companies identifiers to lookup","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MultiCompaniesOverviewsResult"}}},"description":"OK, successful response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}},"description":"Returned when something is wrong in the request, e.g. failed argument validation or arguments are missing"},"404":{"description":"Requested resource could not be found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServerError"}}},"description":"An internal server error occurred, please contact the system administrator with information on the error"}},"summary":"Find overviews by companies id-s","tags":["OverviewFi"]}}},"security":[{"OAuth2":[]}],"servers":[{"url":"https://api.roaring.io/fi/company/overview/1.0"}],"x-category":"company","x-countries":["fi"],"x-id":"OverviewApiFi"}