{"components":{"schemas":{"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"},"CompanySearchResult":{"description":"Roaring Apps company search. list contains all possible fields returned","properties":{"hitCount":{"description":"Total hit count","format":"int32","type":"integer"},"hits":{"description":"Array of hits on the search","items":{"$ref":"#/components/schemas/SearchHit"},"type":"array"},"metrics":{"allOf":[{"$ref":"#/components/schemas/MetricsResult"}],"description":"Metrics connected to the search"},"next":{"description":"url for fetching the next page of search data","type":"string"},"previous":{"description":"url for fetching the previous page of search data","type":"string"},"requestKey":{"description":"Request key","type":"string"}},"type":"object"},"MetricsResult":{"description":"Metrics connected to the search","properties":{"bankruptcy":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"},"commune":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"},"compulsorySettlementOrLiquidation":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"},"countryCode":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"},"deleted":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"},"foretaksregisteretReg":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"},"frivillighetsregisteretReg":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"},"industryCode":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"},"insektCode":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"},"legalGroupCode":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"},"numberCompanyUnits":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"},"numberEmployees":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"},"settlementReg":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"},"stiftelseregisteretReg":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"},"town":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"},"vatReg":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"},"zipCode":{"additionalProperties":{"format":"int32","type":"integer"},"maxProperties":100,"type":"object"}},"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"},"SearchHit":{"description":"hit of the search","properties":{"companyId":{"description":"National identifier for the company","type":"string"},"companyName":{"description":"Name of the company","type":"string"},"legalGroupCode":{"description":"Which kind of company it is","type":"string"},"legalGroupText":{"description":"Description of which kind of company it is","type":"string"},"town":{"description":"The Town the company resides in","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"}},"securitySchemes":{"OAuth2":{"flows":{"clientCredentials":{"scopes":{},"tokenUrl":"https://api.roaring.io/token"}},"type":"oauth2"}}},"info":{"description":"Company Search enables searching for a specific company or a selection of companies based on free text and variables such as, geography, company type, number of employees etc. perfect for creating prospect list for example.\n\nThe Company Search API lets you find specific companies or create targeted company lists using free text or search filters like geography, company type, and number of employees — perfect for prospecting, onboarding, or market analysis.\n\nWith this API you can:\n\n- Find individual companies\n- Build prospect lists based on filters like location, size, and business type\n- Search in our sandbox environment using test companies\n\n**Note:**\n\nUsing placeholder company IDs keeps the service free of charge. (Learn more here https://help.roaring.io/en/articles/154766-company-search.)\n\n**Use case:**\n\nA financial institution onboarding a new B2B customer uses the Company Search API to quickly identify and shortlist potential business customers in a specific region and employee size range, helping sales teams prioritize outreach and onboarding efforts.\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","title":"Company Search","version":"2.0","x-logo":{"url":"https://assets.roaring.io/svg/company-search-v3.1.svg"}},"openapi":"3.0.1","paths":{"/search":{"get":{"description":"Search companies matching query string parameters.\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| Company V | [/no/company/search/2.0/search?freeText=Company V](#L25vL2NvbXBhbnkvc2VhcmNoLzIuMC9zZWFyY2g_ZnJlZVRleHQ9Q29tcGFueSBW) |\n| company search AS Company Z  | [/no/company/search/2.0/search?freeText=Company Z](#L25vL2NvbXBhbnkvc2VhcmNoLzIuMC9zZWFyY2g_ZnJlZVRleHQ9Q29tcGFueSBa) |\n| Company X | [/no/company/search/2.0/search?freeText=Company X](#L25vL2NvbXBhbnkvc2VhcmNoLzIuMC9zZWFyY2g_ZnJlZVRleHQ9Q29tcGFueSBY) |\n| LUFTAMBULANSETJENESTEN HF | [/no/company/search/2.0/search?freeText=LUFTAMBULANSETJENESTEN](#L25vL2NvbXBhbnkvc2VhcmNoLzIuMC9zZWFyY2g_ZnJlZVRleHQ9TFVGVEFNQlVMQU5TRVRKRU5FU1RFTg==) |\n| Company Search Innovation X AS | [/no/company/search/2.0/search?freeText=Innovation X AS](#L25vL2NvbXBhbnkvc2VhcmNoLzIuMC9zZWFyY2g_ZnJlZVRleHQ9SW5ub3ZhdGlvbiBYIEFT) |\n| AXESOS OSLO AS | [/no/company/search/2.0/search?freeText=axesos](#L25vL2NvbXBhbnkvc2VhcmNoLzIuMC9zZWFyY2g_ZnJlZVRleHQ9YXhlc29z) |\n| Company K | [/no/company/search/2.0/search?freeText=Company K ](#L25vL2NvbXBhbnkvc2VhcmNoLzIuMC9zZWFyY2g_ZnJlZVRleHQ9Q29tcGFueSBLIA==) |\n| HitCount: 0 | [/no/company/search/2.0/search?freeText=abc](#L25vL2NvbXBhbnkvc2VhcmNoLzIuMC9zZWFyY2g_ZnJlZVRleHQ9YWJj) |\n| HitCount: 5 | [/no/company/search/2.0/search?freeText=a](#L25vL2NvbXBhbnkvc2VhcmNoLzIuMC9zZWFyY2g_ZnJlZVRleHQ9YQ==) |\n","operationId":"search","parameters":[{"description":"Used when paging in a previous searched result","in":"query","name":"requestKey","schema":{"type":"string"}},{"description":"Number of results to return per pagination page","in":"query","name":"pageSize","schema":{"format":"int32","type":"integer"}},{"description":"first result to return from the resultset that is being paged through","in":"query","name":"from","schema":{"format":"int32","type":"integer"}},{"description":"Town the searched for company should be registered in","explode":true,"in":"query","name":"town","schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Commune the searched for company should be registered in","explode":true,"in":"query","name":"commune","schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Zip code the searched for company should be registered in","explode":true,"in":"query","name":"zipCode","schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Country code the searched for company should be registered in","explode":true,"in":"query","name":"countryCode","schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"The primary industry code the company to search for belongs to","explode":true,"in":"query","name":"industryCode","schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"The legal group code for the type of company to search for","in":"query","name":"legalGroupCode","schema":{"format":"int32","type":"integer"}},{"description":"The institutional sector code for company to search for","in":"query","name":"insektCode","schema":{"format":"int32","type":"integer"}},{"description":"The searched for company should be in bankruptcy, true/false","in":"query","name":"bankruptcy","schema":{"type":"boolean"}},{"description":"The searched for company should be deleted, true/false","in":"query","name":"deleted","schema":{"type":"boolean"}},{"description":"The searched for company should be under liquidation, true/false","in":"query","name":"settlementReg","schema":{"type":"boolean"}},{"description":"The searched for company should be under forced liquidation or dissolution, true/false","in":"query","name":"compulsorySettlementOrLiquidation","schema":{"type":"boolean"}},{"description":"The searched for company should be registered for VAT, true/false","in":"query","name":"vatReg","schema":{"type":"boolean"}},{"description":"The searched for company should be registered in free will vat registry, true/false","in":"query","name":"frivillighetsregisteretReg","schema":{"type":"boolean"}},{"description":"The searched for company should be registered in founder registry, true/false","in":"query","name":"stiftelseregisteretReg","schema":{"type":"boolean"}},{"description":"The searched for company should be registered in enterprise registry, true/false","in":"query","name":"foretaksregisteretReg","schema":{"type":"boolean"}},{"description":"The date the company searched for should have been registered, range input with : between is accepted","in":"query","name":"companyRegistrationDate","schema":{"type":"string"}},{"description":"Number of units the company searched for should have, range input with : between is accepted","in":"query","name":"numberCompanyUnits","schema":{"type":"string"}},{"description":"Number of employees the company searched for should have, range input with : between is accepted","in":"query","name":"numberEmployees","schema":{"type":"string"}},{"description":"The legal group name for the type of company to search for","explode":true,"in":"query","name":"legalGroupText","schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Search by either company name, company id, unit name or unit orgId","in":"query","name":"freeText","schema":{"type":"string"}},{"description":"Net sales, range type, tkr","in":"query","name":"plNetSales","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanySearchResult"}}},"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":"Search companies","tags":["no-CompanySearch"],"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/search/2.0/search'"}]}}},"security":[{"OAuth2":[]}],"servers":[{"url":"https://api.roaring.io/no/company/search/2.0"}],"x-category":"company","x-countries":["no"],"x-id":"no-CompanySearch"}