{"source":"firmafakta","operation":"finn_selskaper_i_omrade","description":"Find companies within a radius of a point, nearest first.","parameters":[{"name":"postnummer","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."},{"name":"lat","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."},{"name":"lon","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."},{"name":"adresse","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."},{"name":"radius_km","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."},{"name":"naeringskoder","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."},{"name":"min_employees","schema":{"default":null,"description":"Minimum number of employees.","type":"integer"},"required":false,"default":null,"description":"Minimum number of employees."},{"name":"max_employees","schema":{"default":null,"description":"Maximum number of employees.","type":"integer"},"required":false,"default":null,"description":"Maximum number of employees."},{"name":"limit","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."},{"name":"offset","schema":{"default":0,"description":"Number of companies to skip.","type":"integer"},"required":false,"default":0,"description":"Number of companies to skip."}],"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":{"anyOf":[{"type":"string"},{"type":"object","properties":{"summary":{"type":"object","properties":{"center":{"type":"string"},"center_coordinates":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"additionalProperties":false},"radius_km":{"type":["number","null"]},"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"}]}},"additionalProperties":false},"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","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"}},"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_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"},"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","summary.note","pagination","pagination.current_offset","pagination.limit","pagination.next_offset","companies"],"output_fields_truncated":false,"canonical_field_aliases":{"latitude":["summary.center_coordinates.latitude"],"longitude":["summary.center_coordinates.longitude"]}}