{"components":{"schemas":{"Address":{"description":"Registered address","properties":{"addressLines":{"description":"List of address lines","items":{"description":"List of address lines","type":"string"},"type":"array"},"countryCode":{"description":"Country code","type":"string"},"countryText":{"description":"Country text","type":"string"},"municipalityCode":{"description":"Municipality code","type":"string"},"municipalityText":{"description":"Municipality text","type":"string"},"postalTown":{"$ref":"#/components/schemas/PostalTown"}},"type":"object"},"AddressInformation":{"description":"Known addresses of the company","properties":{"postalAddress":{"$ref":"#/components/schemas/Address"},"registeredAddress":{"$ref":"#/components/schemas/Address"}},"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"},"CodeAndText":{"description":"Company type code and text","properties":{"code":{"type":"string"},"text":{"type":"string"}},"type":"object"},"CompulsorySettlementOrLiquidationDetail":{"description":"Details regarding settlement/compulsory liquidation","properties":{"reasonCode":{"description":"Reason code of compulsory settlement or liquidation, true/false","type":"string"},"registrationDate":{"description":"The date when the compulsory settlement or liquidation started","type":"string"}},"type":"object"},"Contact":{"description":"Company additional contact information","properties":{"webAddress":{"description":"Web page address","type":"string"}},"type":"object"},"EmployeeDetails":{"description":"Data regarding employee number","properties":{"hasEmployees":{"description":"The company is registered as employer in NAV aa-register (true/false)","type":"boolean"},"numberEmployees":{"description":"Number of employees (if 1-4 employees, this field will not exist. 0 = the company has not registered any employees)","format":"int32","type":"integer"}},"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":{"addressInformation":{"$ref":"#/components/schemas/AddressInformation"},"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":"Name of the company","type":"string"},"contact":{"$ref":"#/components/schemas/Contact"},"employees":{"$ref":"#/components/schemas/EmployeeDetails"},"enhetsregisteretRegistrationDate":{"description":"Company registration date (Date in ISO 8601 standard)","type":"string"},"foretaksregisteretRegistered":{"description":"If registered in Foretaksregisteret, true/false","type":"boolean"},"foundationRegistrationDate":{"description":"Company foundation date (Date in ISO 8601 standard)","type":"string"},"frivillighetsregisteretRegistered":{"description":"If registered in Frivillighetsregisteret, true/false","type":"boolean"},"industrialSector":{"$ref":"#/components/schemas/CodeAndText"},"industry":{"$ref":"#/components/schemas/CodeAndText"},"language":{"description":"Main language","type":"string"},"latestPublishedAnnualReportYear":{"description":"Year for last submitted annual accounts report","type":"string"},"legalGroup":{"$ref":"#/components/schemas/CodeAndText"},"mainUnitCompanyId":{"description":"Org number of the main unit. Only present if the overview represents a sub-unit.","type":"string"},"numberCompanyUnits":{"description":"Number of company units/workplaces","format":"int32","type":"integer"},"parentUnitCompanyId":{"description":"National identifier for the parent unit in the public sector","type":"string"},"removed":{"description":"Set to true when company should be removed from storage due to legal requirements","type":"boolean"},"removedDate":{"description":"Date when company is removed from the central companies registry","type":"string"},"specialSituation":{"$ref":"#/components/schemas/SpecialSituation"},"statutesRegistrationDate":{"description":"Registration date of the statutes (vedtekter)","type":"string"},"stiftelseregisteretReg":{"description":"If registered in Stiftelseregisteret, true/false","type":"boolean"},"topDirectorFunction":{"description":"Role of the top director","type":"string"},"topDirectorName":{"description":"Name of the top director","type":"string"},"vatRegistration":{"description":"If registered for VAT, true/false","type":"boolean"},"vatRegistrationText":{"description":"Free text used when the company is voluntarily registered for VAT. Describes the activity","items":{"description":"Free text used when the company is voluntarily registered for VAT. Describes the activity","type":"string"},"type":"array"}},"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"},"PostalTown":{"description":"Postal town information","properties":{"city":{"description":"City","type":"string"},"zipCode":{"description":"Zip code","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"},"SpecialSituation":{"description":"Information regarding situations that the company is going through","properties":{"bankruptcy":{"description":"Shows if the company is in bankruptcy, true/false","type":"boolean"},"bankruptcyOpenedDate":{"description":"The date when the bankruptcy started","type":"string"},"compulsorySettlementOrLiquidation":{"description":"Shows whether the company is in compulsory settlement/compulsory liquidation, true/false","type":"boolean"},"compulsorySettlementsOrLiquidationDetails":{"description":"Details regarding settlement/compulsory liquidation","items":{"$ref":"#/components/schemas/CompulsorySettlementOrLiquidationDetail"},"type":"array"},"dissolution":{"description":"Shows if the company is in dissolution, true/false","type":"boolean"},"dissolutionRegistrationDate":{"description":"The date when the dissolution started","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 company data, including:**\n\n- Company name and address\n- Status and industry\n- Number of employees\n- Top-executive\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# 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\nCode  |  Description (Norsk)  |  Description (English)\n --- | --- | ---\nAAFY  |  Underenhet til ikke-næringsdrivende  |  Subunit to non-commercial\nADOS  |  Administrativ enhet - offentlig sektor  |  Administrative entity - public sector\nANNA  |  Annen juridisk person  |  Other corporate body\nANS  |  Ansvarlig selskap med solidarisk ansvar  |  General partnership\nAS  |  Aksjeselskap  |  Limited company\nASA  |  Allmennaksjeselskap  |  Public limited company\nBA  |  Selskap med begrenset ansvar  |  Company with limited liability\nBBL  |  Boligbyggelag  |  House building cooperative\nBEDR  |  Underenhet til næringsdrivende og offentlig forvaltning  |  Subunit of enterprise\nBO  |  Andre bo  |  Other estates\nBRL  |  Borettslag  |  Housing cooperative\nDA  |  Ansvarlig selskap med delt ansvar  |  General partnership with shared liability\nENK  |  Enkeltpersonforetak  |  Sole proprietorship\nESEK  |  Eierseksjonssameie  |  Condominium flat owner\nFKF  |  Fylkeskommunalt foretak  |  County municipal business enterprise\nFLI  |  Forening/lag/innretning  |  Association/club/organization\nFYLK  |  Fylkeskommune  |  County municipality\nGFS  |  Gjensidig forsikringsselskap  |  Mutual insurance company\nIKJP  |  Andre ikke-juridiske personer  |  Other non-body corporate\nIKS  |  Interkommunalt selskap  |  Inter-municipal company\nKBO  |  Konkursbo  |  Bankrupt estate\nKF  |  Kommunalt foretak  |  Municipal business enterprise\nKIRK  |  Den norske kirke  |  The Church of Norway\nKOMM  |  Kommune  |  Municipality\nKS  |  Kommandittselskap  |  Limited partnership\nKTRF  |  Kontorfellesskap  |  Joint office\nNUF  |  Norskregistrert utenlandsk foretak  |  Norwegian registered foreign business\nOPMV  |  Særskilt oppdelt enhet, jf. mval. § 2-2  |  Specially sectioned unit\nORGL  |  Organisasjonsledd  |  Organizational section\nPERS  |  Andre enkeltpersoner som registreres i tilknyttet register  |  Other individuals registered in affiliated register\nPK  |  Pensjonskasse  |  Pension fund\nPRE  |  Partrederi  |  Jointly owned shipping company\nSA  |  Samvirkeforetak  |  Co-operative\nSÆR  |  Annet foretak iflg. særskilt lov  |  Other business enterprise in accordance with special legislation\nSAM  |  Tingsrettslig sameie  |  Joint ownership according to the law of property\nSE  |  Europeisk selskap  |  European company\nSF  |  Statsforetak  |  Public corporation\nSPA  |  Sparebank  |  Sparebank\nSTAT  |  Staten  |  State\nSTI  |  Stiftelse  |  Foundation\nTVAM  |  Tvangsregistrert for MVA  |  Compulsory registration in the Value Added Tax Register\nUTLA  |  Utenlandsk enhet  |  Foreign establishment\nVPFO  |  Verdipapirfond  |  Unit trusts\n\n# Industry Codes\nFrom 1st Sept2025, the Norwegian industry code standard is Norsk Standard for næringsgruppering (SN2025). \nIt is a 5-digit subdivision of the 4-digit NACE rev 2.1 standard.\nThe change affects all active companies.\nSee: [SN2025](https://www.ssb.no/klass/klassifikasjoner/6/versjon/3218/koder)\n\n\nBefore 1st Sept 2025, the standard was called SN2007, see: [SN2007](https://www.ssb.no/klass/klassifikasjoner/6/versjon/30/koder) \n\nThe correct text connected to the industry code is always present in the api response (in Norwegian).\n\n# Compulsory Settlement Codes\nReason codes for compulsory settlement or liquidation\n\nCode  |  Description (English)  |  Description (Norsk)\n --- | --- | ---\nLIQUIDATION  |  More than a year in voluntary liquidation |  Slettemelding I frivillig avvikkling ikke mottatt innen ett år\nMISSING_CEO  |  CEO missing  |  Manglende daglig leder\nMISSING_AUDITOR  |  Auditor missing  |  Mangled revisor\nMISSING_ACCOUNTS  |  Missing financial statement  |  Manglende Regnskap\nBOARD_INCOMPLETE  |  Incomplete board  |  Mangler fullt styre\n\n","title":"Company Information","version":"4.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| Example of company where number of employees is not specified | [/no/company/overview/4.0/926597590](#L25vL2NvbXBhbnkvb3ZlcnZpZXcvNC4wLzkyNjU5NzU5MA==) |\n| Searching for an establishment/subentity- the main company is shown as mainUnitCompanyId | [/no/company/overview/4.0/971802685](#L25vL2NvbXBhbnkvb3ZlcnZpZXcvNC4wLzk3MTgwMjY4NQ==) |\n| Example of a company under liquidation and dissolution | [/no/company/overview/4.0/999555365](#L25vL2NvbXBhbnkvb3ZlcnZpZXcvNC4wLzk5OTU1NTM2NQ==) |\n| FLI: Association/club/organisation, Forening/Lag/Innretning | [/no/company/overview/4.0/811556912](#L25vL2NvbXBhbnkvb3ZlcnZpZXcvNC4wLzgxMTU1NjkxMg==) |\n| BA: Company with limited liability, Selskap Med Begrenset Ansvar | [/no/company/overview/4.0/970232222](#L25vL2NvbXBhbnkvb3ZlcnZpZXcvNC4wLzk3MDIzMjIyMg==) |\n| Company information | [/no/company/overview/4.0/989781707](#L25vL2NvbXBhbnkvb3ZlcnZpZXcvNC4wLzk4OTc4MTcwNw==) |\n| AS: Limited company, Aksjeselskap with no employees | [/no/company/overview/4.0/810059672](#L25vL2NvbXBhbnkvb3ZlcnZpZXcvNC4wLzgxMDA1OTY3Mg==) |\n| KIRK: Council of Churches, Den norske kirke | [/no/company/overview/4.0/987569166](#L25vL2NvbXBhbnkvb3ZlcnZpZXcvNC4wLzk4NzU2OTE2Ng==) |\n| AS Limited company | [/no/company/overview/4.0/793969015](#L25vL2NvbXBhbnkvb3ZlcnZpZXcvNC4wLzc5Mzk2OTAxNQ==) |\n| AS: Aksjeselskap | [/no/company/overview/4.0/810392312](#L25vL2NvbXBhbnkvb3ZlcnZpZXcvNC4wLzgxMDM5MjMxMg==) |\n| Example of a company that has been removed without any info | [/no/company/overview/4.0/930751936](#L25vL2NvbXBhbnkvb3ZlcnZpZXcvNC4wLzkzMDc1MTkzNg==) |\n| SÆR: Other business enterprise in accordance with special legislation, Annet Foretak Iflg. Særsk. Lov  | [/no/company/overview/4.0/818711832](#L25vL2NvbXBhbnkvb3ZlcnZpZXcvNC4wLzgxODcxMTgzMg==) |\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":["no-Overview"],"x-code-samples":[{"lang":"Shell","source":"curl -X GET --header 'Accept: application/json'\\\n--header 'Authorization: Bearer {ACCESS TOKEN}'\\\n'https://api.roaring.io/no/company/overview/4.0/{companyId}'"}]}},"/history/{companyId}":{"get":{"description":"Changes of the company within specified date range. The range includes \\\"from\\\" and excludes \\\"to\\\".\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| Example of history endpoint for a Company | [/no/company/overview/4.0/history/810059672?fromDate=1999-01-01](#L25vL2NvbXBhbnkvb3ZlcnZpZXcvNC4wL2hpc3RvcnkvODEwMDU5NjcyP2Zyb21EYXRlPTE5OTktMDEtMDE=) |\n","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":["no-Overview"],"x-code-samples":[{"lang":"Shell","source":"curl -X GET --header 'Accept: application/json'\\\n--header 'Authorization: Bearer {ACCESS TOKEN}'\\\n'https://api.roaring.io/no/company/overview/4.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":["no-Overview"]}}},"security":[{"OAuth2":[]}],"servers":[{"url":"https://api.roaring.io/no/company/overview/4.0"}],"x-category":"company","x-countries":["no"],"x-id":"no-Overview"}