search_sub_entities
Search for Norwegian business sub-entities using filters like name, organization number, employee count, registration dates, industry codes, and organizational forms to find specific subsidiary information.
Instructions
Search for Norwegian business sub-entities (underenheter) with various filters
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fraAntallAnsatte | No | Minimum number of employees | |
| fraDatoEierskifte | No | Ownership change date from (ISO-8601 yyyy-MM-dd) | |
| fraNedleggelsesdato | No | Closure date from (ISO-8601 yyyy-MM-dd) | |
| fraOppstartsdato | No | Start date from (ISO-8601 yyyy-MM-dd) | |
| hjemmeside | No | Website | |
| kommunenummer | No | Municipality numbers | |
| naeringskode | No | Industry codes | |
| navn | No | Sub-entity name (1-180 characters) | |
| navnMetodeForSoek | No | Search method for name parameter | |
| organisasjonsform | No | Organizational forms | |
| organisasjonsnummer | No | List of organization numbers (9 digits) | |
| overordnetEnhet | No | Parent entity organization number | |
| page | No | Page number | |
| registrertIMvaregisteret | No | Registered in VAT registry | |
| size | No | Page size (default 20) | |
| sort | No | Sort field and order | |
| tilAntallAnsatte | No | Maximum number of employees | |
| tilDatoEierskifte | No | Ownership change date to (ISO-8601 yyyy-MM-dd) | |
| tilNedleggelsesdato | No | Closure date to (ISO-8601 yyyy-MM-dd) | |
| tilOppstartsdato | No | Start date to (ISO-8601 yyyy-MM-dd) |
Implementation Reference
- src/brreg-mcp-server.ts:91-93 (handler)Core handler function in BrregApiClient that performs the API request to search for Norwegian business sub-entities (underenheter).async searchSubEntities(params: SubEntitySearchParams = {}) { return this.makeRequest('/enhetsregisteret/api/underenheter', params); }
- src/brreg-mcp-server.ts:38-45 (schema)TypeScript interface defining the input parameters for the searchSubEntities tool, extending EntitySearchParams with additional date filters.interface SubEntitySearchParams extends Omit<EntitySearchParams, 'konkurs' | 'underTvangsavviklingEllerTvangsopplosning' | 'underAvvikling' | 'underKonkursbehandling'> { fraOppstartsdato?: string; tilOppstartsdato?: string; fraDatoEierskifte?: string; tilDatoEierskifte?: string; fraNedleggelsesdato?: string; tilNedleggelsesdato?: string; }
- src/brreg-mcp-server.ts:233-260 (registration)MCP tool registration including name, description, and detailed input JSON schema.name: "search_sub_entities", description: "Search for Norwegian business sub-entities (underenheter) with various filters", inputSchema: { type: "object", properties: { navn: { type: "string", description: "Sub-entity name (1-180 characters)" }, navnMetodeForSoek: { type: "string", enum: ["FORTLOEPENDE"], description: "Search method for name parameter" }, organisasjonsnummer: { type: "array", items: { type: "string" }, description: "List of organization numbers (9 digits)" }, overordnetEnhet: { type: "string", description: "Parent entity organization number" }, fraAntallAnsatte: { type: "number", description: "Minimum number of employees" }, tilAntallAnsatte: { type: "number", description: "Maximum number of employees" }, registrertIMvaregisteret: { type: "boolean", description: "Registered in VAT registry" }, fraOppstartsdato: { type: "string", description: "Start date from (ISO-8601 yyyy-MM-dd)" }, tilOppstartsdato: { type: "string", description: "Start date to (ISO-8601 yyyy-MM-dd)" }, fraDatoEierskifte: { type: "string", description: "Ownership change date from (ISO-8601 yyyy-MM-dd)" }, tilDatoEierskifte: { type: "string", description: "Ownership change date to (ISO-8601 yyyy-MM-dd)" }, fraNedleggelsesdato: { type: "string", description: "Closure date from (ISO-8601 yyyy-MM-dd)" }, tilNedleggelsesdato: { type: "string", description: "Closure date to (ISO-8601 yyyy-MM-dd)" }, organisasjonsform: { type: "array", items: { type: "string" }, description: "Organizational forms" }, hjemmeside: { type: "string", description: "Website" }, kommunenummer: { type: "array", items: { type: "string" }, description: "Municipality numbers" }, naeringskode: { type: "array", items: { type: "string" }, description: "Industry codes" }, size: { type: "number", description: "Page size (default 20)" }, page: { type: "number", description: "Page number" }, sort: { type: "string", description: "Sort field and order" } } } },
- src/brreg-mcp-server.ts:437-446 (handler)MCP CallToolRequest handler case that invokes the searchSubEntities method and returns the JSON-formatted results.case "search_sub_entities": const subEntityResults = await apiClient.searchSubEntities(request.params.arguments as SubEntitySearchParams); return { content: [ { type: "text", text: JSON.stringify(subEntityResults, null, 2), }, ], };