{"source":"firmafakta","operation":"finn_selskaper_i_omrade","description":"Find companies within a radius of a point, nearest first. Signature: finn_selskaper_i_omrade(postnummer: string, optional, default None; lat: decimal number, decimal degrees (WGS84), optional, default None; lon: decimal number, decimal degrees (WGS84), optional, default None; adresse: string, optional, default None; radius_km: decimal number, kilometres, optional, default 5.0; naeringskoder: list of string (comma-separated), optional, default None; min_employees: integer, optional, default None; max_employees: integer, optional, default None; limit: integer, items, optional, default 30; offset: integer, items, optional, default 0).","signature":"finn_selskaper_i_omrade(postnummer: string, optional, default None; lat: decimal number, decimal degrees (WGS84), optional, default None; lon: decimal number, decimal degrees (WGS84), optional, default None; adresse: string, optional, default None; radius_km: decimal number, kilometres, optional, default 5.0; naeringskoder: list of string (comma-separated), optional, default None; min_employees: integer, optional, default None; max_employees: integer, optional, default None; limit: integer, items, optional, default 30; offset: integer, items, optional, default 0)","parameters":[{"name":"postnummer","type":"string","schema":{"default":null,"description":"Norwegian 4-digit postal code to centre the search on (e.g. '0150'). The centre becomes that postal code's location. Ignored if lat+lon are given.","type":"string"},"required":false,"default":null,"description":"Norwegian 4-digit postal code to centre the search on (e.g. '0150'). The centre becomes that postal code's location. Ignored if lat+lon are given.","unit":null},{"name":"lat","type":"number","schema":{"default":null,"description":"Latitude of the centre point (WGS84). Provide together with lon to search around exact coordinates.","type":"number"},"required":false,"default":null,"description":"Latitude of the centre point (WGS84). Provide together with lon to search around exact coordinates. Unit: decimal degrees (WGS84).","unit":"decimal degrees (WGS84)"},{"name":"lon","type":"number","schema":{"default":null,"description":"Longitude of the centre point (WGS84). Provide together with lat.","type":"number"},"required":false,"default":null,"description":"Longitude of the centre point (WGS84). Provide together with lat. Unit: decimal degrees (WGS84).","unit":"decimal degrees (WGS84)"},{"name":"adresse","type":"string","schema":{"default":null,"description":"Street address (e.g. 'Karl Johans gate 1') used together with postnummer to centre the search on that address. Falls back to the postal code centre if the address is not found.","type":"string"},"required":false,"default":null,"description":"Street address (e.g. 'Karl Johans gate 1') used together with postnummer to centre the search on that address. Falls back to the postal code centre if the address is not found.","unit":null},{"name":"radius_km","type":"number","schema":{"default":5.0,"description":"Search radius in kilometres from the centre. Capped at 50 km.","type":"number"},"required":false,"default":5.0,"description":"Search radius in kilometres from the centre. Capped at 50 km. Unit: kilometres.","unit":"kilometres"},{"name":"naeringskoder","type":"array","schema":{"default":null,"description":"Optional list of naeringskoder to filter by, e.g. ['56.101']. A short prefix like '41' matches every code under it. Use list_naeringskoder to find codes.","items":{"type":"string"},"type":"array"},"required":false,"default":null,"description":"Optional list of naeringskoder to filter by, e.g. ['56.101']. A short prefix like '41' matches every code under it. Use list_naeringskoder to find codes.","unit":null},{"name":"min_employees","type":"integer","schema":{"default":null,"description":"Minimum number of employees.","type":"integer"},"required":false,"default":null,"description":"Minimum number of employees.","unit":null},{"name":"max_employees","type":"integer","schema":{"default":null,"description":"Maximum number of employees.","type":"integer"},"required":false,"default":null,"description":"Maximum number of employees.","unit":null},{"name":"limit","type":"integer","schema":{"default":30,"description":"Max companies to return, nearest first. Capped at 100; use offset to page.","type":"integer"},"required":false,"default":30,"description":"Max companies to return, nearest first. Capped at 100; use offset to page. Unit: items.","unit":"items"},{"name":"offset","type":"integer","schema":{"default":0,"description":"Number of companies to skip.","type":"integer"},"required":false,"default":0,"description":"Number of companies to skip. Unit: items.","unit":"items"}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/firmafakta/finn_selskaper_i_omrade?postnummer={postnummer}&lat={lat}&lon={lon}&adresse={adresse}&radius_km=5.0&naeringskoder={naeringskoder}&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":{"center":{"type":"string"},"center_coordinates":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"additionalProperties":false,"required":["latitude","longitude"]},"radius_km":{"type":"number"},"total_matching":{"type":"integer"},"showing":{"type":"string"},"has_more_results":{"type":"boolean"}},"additionalProperties":false,"required":["center","center_coordinates","radius_km","total_matching","showing","has_more_results"]},"pagination":{"type":"object","properties":{"current_offset":{"type":"integer"},"limit":{"type":"integer"},"next_offset":{"type":["integer","null"]}},"additionalProperties":false,"required":["current_offset","limit","next_offset"]},"companies":{"type":"array","items":{"type":"object","properties":{"organization_id":{"type":["string","null"]},"navn":{"type":["string","null"]},"organisasjonsform":{"type":"object","properties":{"kode":{"type":["string","null"]},"beskrivelse":{"type":["string","null"]}},"additionalProperties":false},"naeringskode1":{"type":"object","properties":{"kode":{"type":["string","null"]},"beskrivelse":{"type":["string","null"]}},"additionalProperties":false},"antallAnsatte":{"type":["integer","null"]},"hjemmeside":{"type":["string","null"]},"epostadresse":{"type":["string","null"]},"telefon":{"type":["string","null"]},"forretningsadresse":{"type":"object","properties":{"adresse":{"type":["string","null"]},"poststed":{"type":["string","null"]},"postnummer":{"type":["string","null"]},"kommune":{"type":["string","null"]}},"additionalProperties":false},"stiftelsesdato":{"type":["string","null"],"format":"date"},"registreringsdatoenhetsregisteret":{"type":["string","null"],"format":"date"},"aktivitet":{"type":["string","null"]},"vedtektsfestetFormaal":{"type":["string","null"]},"distance_km":{"type":"number"},"coordinates":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"additionalProperties":false,"required":["latitude","longitude"]}},"additionalProperties":false,"required":["organization_id","navn","distance_km","coordinates"]}}},"additionalProperties":false,"required":["summary","pagination","companies"]},"response_schema_status":{"status":"declared","codegen_safe":true,"description":"Maintained response contract."},"entity_projection":{"status":"projected","entity_types":["organization","place"],"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"},"feedback":{"type":"string","format":"uri"}},"required":["self","api_index","feedback"],"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_i_omrade/schema","operation":"https://allemannsdata.com/wiki/api/v1/kilder/firmafakta/finn_selskaper_i_omrade","source":"https://allemannsdata.com/wiki/api/v1/kilder/firmafakta","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"},"output_fields":["summary","summary.center","summary.center_coordinates","summary.center_coordinates.latitude","summary.center_coordinates.longitude","summary.radius_km","summary.total_matching","summary.showing","summary.has_more_results","pagination","pagination.current_offset","pagination.limit","pagination.next_offset","companies","companies[].organization_id","companies[].navn","companies[].organisasjonsform","companies[].organisasjonsform.kode","companies[].organisasjonsform.beskrivelse","companies[].naeringskode1","companies[].naeringskode1.kode","companies[].naeringskode1.beskrivelse","companies[].antallAnsatte","companies[].hjemmeside","companies[].epostadresse","companies[].telefon","companies[].forretningsadresse","companies[].forretningsadresse.adresse","companies[].forretningsadresse.poststed","companies[].forretningsadresse.postnummer"],"output_fields_truncated":true,"canonical_field_aliases":{"latitude":["summary.center_coordinates.latitude","companies[].coordinates.latitude"],"longitude":["summary.center_coordinates.longitude","companies[].coordinates.longitude"],"name":["companies[].navn"],"identifier":["companies[].organisasjonsform.kode","companies[].naeringskode1.kode"],"employee_count":["companies[].antallAnsatte"],"date":["companies[].registreringsdatoenhetsregisteret"]},"response_example":{"source":"firmafakta","operation":"finn_selskaper_i_omrade","parameters":{"postnummer":null,"lat":null,"lon":null,"adresse":null,"radius_km":5.0,"naeringskoder":["example value"],"min_employees":null,"max_employees":null,"limit":30,"offset":0},"data":{"summary":{"center":"example value","center_coordinates":{"latitude":59.91,"longitude":10.75},"radius_km":1.0,"total_matching":1,"showing":"example value","has_more_results":true},"pagination":{"current_offset":1,"limit":1,"next_offset":1},"companies":[{"organization_id":"example-id","navn":"example value","organisasjonsform":{"kode":"example value","beskrivelse":"example value"},"naeringskode1":{"kode":"example value","beskrivelse":"example value"},"antallAnsatte":1,"hjemmeside":"example value","epostadresse":"example value","telefon":"example value","forretningsadresse":{"adresse":"example value","poststed":"example value","postnummer":"example value","kommune":"example value"},"stiftelsesdato":"2026-01-15","registreringsdatoenhetsregisteret":"2026-01-15","aktivitet":"example value","vedtektsfestetFormaal":"example value","distance_km":1.0,"coordinates":{"latitude":59.91,"longitude":10.75}}]},"entities":[],"_meta":{"retrieved_at":"2026-01-15T12:00:00Z","language":"en","content_languages":["en"],"sources":[{"id":"firmafakta","name":"Firmafakta","description":"Norwegian businesses, people, roles, owners, accounts, grants, jobs and intellectual property.","cache_ttl_seconds":60}]},"_provenance":{"data":{"source":"firmafakta","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/firmafakta"},"entities":{"source":"firmafakta","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/firmafakta","derived_from":"#/data","description":"Normalized projection of data."}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/firmafakta/finn_selskaper_i_omrade","source":"https://allemannsdata.com/wiki/api/v1/kilder/firmafakta","wiki":"https://allemannsdata.com/wiki/kilder/firmafakta/finn_selskaper_i_omrade/","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"}}}