{"source":"firmafakta","operation":"finn_selskaper","description":"Search for companies by location (kommune or fylke), optionally filtered by business activity codes, company age and employee count.","parameters":[{"name":"kommune","schema":{"default":null,"description":"Municipality to filter companies by (e.g., 'Oslo', 'Bergen', 'Trondheim'). Optional if fylke is provided.","type":"string"},"required":false,"default":null,"description":"Municipality name (e.g., \"Oslo\", \"Bergen\", \"Stavanger\"). Optional if fylke is provided."},{"name":"fylke","schema":{"default":null,"description":"County/region to filter companies by (e.g., 'Vestland', 'Oslo', 'Tr\u00f8ndelag', 'Rogaland'). Optional if kommune is provided.","type":"string"},"required":false,"default":null,"description":"County/region name. Optional if kommune is provided."},{"name":"naeringskoder","schema":{"default":null,"description":"List of Norwegian business activity codes (naeringskoder) to filter by, e.g. ['56.101', '56.102']. A short prefix like '41' matches every code under it (all of section 41). Use list_naeringskoder to find relevant codes for a business segment. Optional.","items":{"type":"string"},"type":"array"},"required":false,"default":null,"description":"List of business activity codes to filter by. Optional - if not provided, returns all companies in the location. Call list_naeringskoder to look up codes for a segment."},{"name":"min_age","schema":{"default":null,"description":"Minimum company age in years. Companies must have been founded at least this many years ago.","type":"integer"},"required":false,"default":null,"description":"Minimum company age in years (calculated from stiftelsesdato)."},{"name":"max_age","schema":{"default":null,"description":"Maximum company age in years. Companies must have been founded at most this many years ago.","type":"integer"},"required":false,"default":null,"description":"Maximum company age in years (calculated from stiftelsesdato)."},{"name":"min_employees","schema":{"default":null,"description":"Minimum number of employees. Only returns companies with at least this many employees.","type":"integer"},"required":false,"default":null,"description":"Minimum number of employees."},{"name":"max_employees","schema":{"default":null,"description":"Maximum number of employees. Only returns companies with at most this many employees.","type":"integer"},"required":false,"default":null,"description":"Maximum number of employees."},{"name":"limit","schema":{"default":30,"description":"Maximum number of companies to return. Capped at 100; use offset to page through larger result sets.","type":"integer"},"required":false,"default":30,"description":"Maximum number of companies to return. Default is 30, capped at 100."},{"name":"offset","schema":{"default":0,"description":"Number of companies to skip.","type":"integer"},"required":false,"default":0,"description":"Number of companies to skip. Default is 0."}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/firmafakta/finn_selskaper?kommune={kommune}&fylke={fylke}&naeringskoder={naeringskoder}&min_age={min_age}&max_age={max_age}&min_employees={min_employees}&max_employees={max_employees}&limit=30&offset=0","schema_scope":"#/data in the successful operation envelope","response_schema":{"type":"object","properties":{"summary":{"type":"object","properties":{"total_matching":{"type":["integer","null"]},"showing":{"type":"string"},"has_more_results":{"type":"boolean"},"note":{"type":"string"}},"additionalProperties":false},"pagination":{"type":"object","properties":{"current_offset":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},"limit":{"type":["integer","null"]},"next_offset":{"anyOf":[{"anyOf":[{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},{"type":["integer","null"]}]},{"type":"null"}]},"tip":{"type":"string"}},"additionalProperties":false},"applied_filters":{"type":"object","properties":{"location":{"anyOf":[{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},{"type":"string"}]},"naeringskoder":{"anyOf":[{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},{"type":"string"}]},"age_range":{"type":"string"},"employee_range":{"type":"string"}},"additionalProperties":false},"filter_tips":{"type":"array","items":{"anyOf":[{"anyOf":[{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."},{"type":"string"}]},{"type":"string"}]}},"companies":{"type":"array","items":{"x-allemannsdata-schema-status":"unresolved","description":"Response shape is not yet declared; any JSON value is permitted."}}},"additionalProperties":false},"response_schema_status":{"status":"incomplete","codegen_safe":false,"description":"Not suitable for typed model generation: the container shape and field names are useful, but unresolved values accept any JSON value."},"entity_projection":{"status":"projected","entity_types":["organization"],"description":"Recognized records and stable operation identifiers are projected; an empty array means the successful payload contained no recognizable entity."},"error_contract":{"scope":"top-level HTTP error response; never part of a success payload","schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"details":{"type":"object"}},"additionalProperties":false,"required":["code","message","retryable"]},"suggestion":{"type":"string"},"_meta":{"type":"object","properties":{"retrieved_at":{"type":"string","format":"date-time"},"language":{"type":"string","const":"en"},"content_languages":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object"}}},"required":["retrieved_at","language","content_languages","sources"]},"_links":{"type":"object","properties":{"self":{"type":"string","format":"uri"},"api_index":{"type":"string","format":"uri"}},"required":["self","api_index"],"additionalProperties":false}},"additionalProperties":false,"required":["error","suggestion","_meta","_links"]},"statuses":{"400":{"codes":["MISSING_PARAMETER","INVALID_PARAMETER","INVALID_REQUEST"],"retryable":false},"404":{"codes":["SOURCE_NOT_FOUND","OPERATION_NOT_FOUND","ENTITY_NOT_FOUND"],"retryable":false},"429":{"codes":["RATE_LIMITED","GATEWAY_RATE_LIMITED"],"retryable":true},"502":{"codes":["SOURCE_UNAVAILABLE"],"retryable":true},"500":{"codes":["INTERNAL_ERROR"],"retryable":true}}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/firmafakta/finn_selskaper/schema","operation":"https://allemannsdata.com/wiki/api/v1/kilder/firmafakta/finn_selskaper","source":"https://allemannsdata.com/wiki/api/v1/kilder/firmafakta"},"output_fields":["summary","summary.total_matching","summary.showing","summary.has_more_results","summary.note","pagination","pagination.current_offset","pagination.limit","pagination.next_offset","pagination.tip","applied_filters","applied_filters.location","applied_filters.naeringskoder","applied_filters.age_range","applied_filters.employee_range","filter_tips","companies"],"output_fields_truncated":false,"canonical_field_aliases":{}}