Changelog

​

Platform

​

💳 New Billing Dashboard & Analytics (Admin-only)

Your organisation admins now have access to a brand-new billing section that makes it easier than ever to understand how credits are being used.

• Flexible global filters – Pick any date range (or quick presets) and choose exactly which users – plus the API – you want to analyse.
• Usage analytics – Interactive bar chart that flips between daily, weekly, or monthly views and can be split by individual user or total.
• Per-request cost tracking – A detailed table shows the exact credit cost for every request, including ones that incurred no charge.
• CSV export – Download the full, filtered history (not just the current page) for deeper analysis in your favourite BI tool.

Head over to Billing → Dashboard (admins only) to explore the new insights.

​

🔧 Field Naming Standardization

• Renamed englishName to englishTranslation - Updated field naming to align with our API naming strategy, maintaining consistency with other translated fields like legalForm. This change ensures a more coherent and predictable API structure across all data points.

​

Countries

​

🇮🇹 Italy

• Improved legal form parsing - Enhanced accuracy and standardization of 70+ Italian legal forms for better company classification. See complete list in our Italy documentation
• Added establishments support - Integrated establishment data with comprehensive location and activity information, including active status indicators
• Enhanced shareholder parsing - Significant improvements to shareholder data extraction, now enabling full support for graphBeta ownership tree analysis
• Added search by VAT and tax code - New search functionality allowing company lookup using Italian VAT numbers (Partita IVA) or tax codes (Codice Fiscale)

​

🇬🇧 United Kingdom

• Improved legal form and role mapping - Enhanced accuracy and standardization of 40+ legal forms and 60+ officer roles with direct mapping to Semaphore standards. See complete lists in our UK documentation
• Standardized company identifiers - Cleaned up identifier structure with consistent naming (companiesHouseNumber and jurisdiction)
• Guaranteed SIC codes - Direct SIC codes from Companies House with AI mapping to NACE and ISIC international standards

​

✨ Week 26 Highlights

• 🇮🇪 Ireland Launch - New support for Irish entities with CRO registry integration for company search and profiles
• 🚀 New Semaphore Portal - Deployed a heavily improved version of our customer portal with enhanced performance, better async handling, and modern design
• 🔧 Enhanced Activity Code Mapping - Improved standardization and accuracy of business activity codes across France, Belgium, and Switzerland

​

Platform

​

🚀 Portal Redesign (app.getsemaphore.com)

We’ve completely redesigned and rebuilt our customer portal from the ground up, delivering a significantly improved user experience with modern architecture and enhanced capabilities.

Key Improvements:

• Enhanced Performance - Faster navigation and reduced loading times across all portal features
• Granular Data Point Control - Precise selection and management of requested data points for optimized queries
• First-Class Async Support - Built-in asynchronous request handling with real-time progress tracking and status updates
• Modern Design - Refreshed interface with improved usability and visual hierarchy
• New Data Points Integration - Native support for Establishments and Other Key People with dedicated UI components

Coming Soon:

• Usage Tracking - Comprehensive analytics and monitoring of API consumption
• Request History - Detailed audit trail of all API requests and responses
• Interactive Ownership Graph - Visual representation of company ownership structures powered by our enhanced graph engine

​

Countries

​

🇮🇪 Ireland

• Initial support for Ireland - We’re excited to announce support for Irish companies with our integration of the Companies Registration Office (CRO)! Currently available features:
  • Company search by name - Find Irish companies using their registered business names
  • Company search by registration number - Direct lookup using CRO registration numbers
  • companyProfile - Access comprehensive company information from the Companies Registration Office
  • Document support coming soon - Full document retrieval functionality will be available in upcoming releases

​

🇫🇷 France

• Fixed activity code mapping - Resolved issues with business activity code standardization and improved accuracy of sector classification for French companies

​

🇧🇪 Belgium

• Fixed activity code mapping - Enhanced processing and standardization of Belgian NACE codes, ensuring better alignment with international classification standards

​

🇨🇭 Switzerland

• Fixed activity code mapping - Improved mapping of Swiss business activity codes (NOGA) to standardized formats, providing more accurate industry classification

​

✨ Week 25 Highlights

• 🎯 Enhanced Ownership Graph Analysis - Improved UBO identification with dual calculation methods and better data visualization
• 🇩🇪 Intelligent German Shareholder Computation - Multi-source extraction strategy with automatic fallbacks
• 🇵🇱 Poland Launch - Full support for Polish entities with CEIDG and KRS registry integration
• 🇦🇹 Austria Launch - We’re excited to announce support for Austrian companies, financial statements and company informations are available.
• 🇱🇺 Luxembourg Trade Registry Extract - New comprehensive document access (up to 1 hour retrieval time)

​

Platform

​

🎯 Enhanced Ownership Graph Analysis

We’ve launched improved ownership graph analysis with better UBO identification and cleaner data presentation, tested with German companies and providing cross-checking capabilities against Transparenzregister data.

Key Improvements:

• Dual calculation methods - Accumulation and domination approaches with 25% ownership threshold
• Corporate UBO flagging when ownership chains end at companies rather than individuals
• Nodes and edges structure for clearer ownership visualization with cross-border support
• Better error handling with partial results, circular ownership detection, and entity deduplication

​

Countries

​

🇩🇪 Germany

Enhanced Multi-Source Shareholder Data Extraction

• Three-source strategy - Gesellschafterliste extraction, trade register analysis, and financial statement analysis (NEW)
• Multi-source validation combines results from different document types for better accuracy
• Transparenzregister cross-checking and automatic fallbacks when primary data sources are unavailable
• Improved Handelsregister fallback for document listing and retrieval with exponential backoff retry logic

​

🇵🇱 Poland

Comprehensive Polish Business Registry Support

• Dual registry coverage - CEIDG (individual businesses) and KRS (companies) with smart ID prefixes
• Complete data points - companyProfile and availableDocuments tailored to entity type
• Document support - Trade register extract for both registries, historical extracts for KRS entities

​

🇪🇸 Spain

• Fixed document retrieval and listing - Resolved deployment issue affecting Spanish document access
• Improved parsing of activities - Enhanced extraction and processing for better accuracy

​

🇮🇹 Italy

• Improved parsing of activities - Enhanced extraction and processing for better accuracy

​

🇫🇷 France

• Fixed Ultimate Beneficial Owner retrieval - Resolved UBO data extraction issues for reliable beneficial ownership information

​

🇲🇹 Malta

• Switched companyProfile to async process - Automatic retry mechanism to overcome registry instability

​

🇵🇹 Portugal

• Improved shareholder parsing - Enhanced extraction and processing of shareholder data

​

🇱🇺 Luxembourg

• Added trade registry extract support - Comprehensive functionality for Luxembourg companies (Note: May take up to one hour due to registry processing time)

​

🇦🇹 Austria

• companyProfile - Access comprehensive company information and legal representatives from the Austrian Firmenbuch
• availableDocuments - Document categorization for financial statements and other documents

​

Platform

• Renamed mostCompleteStatus: The mostCompleteStatus document category has been renamed to mostCompleteArticleOfAssociation to better align with our naming conventions.

​

Countries

​

🇳🇱 Netherlands

• Improved system reliability for Dutch company data retrieval, enhancing stability and reducing error rates.
• Fixed trade_register_extract ID consistency - Resolved an issue where document IDs would change when only the document was required, ensuring stable document references.

​

🇬🇧 United Kingdom

• Added establishments support - Integrated with the UK Companies House establishments endpoint to retrieve branch offices, subsidiaries, and other affiliated locations for UK companies.
• Many improvements - Enhanced documents metadata accuracy, fixed trade register extract listing issues, and improved overall system reliability for UK company data retrieval.

​

🇫🇷 France

• Fixed establishments data - Resolved establishment identification by adding SIRET as ID and corrected establishment names for improved accuracy and consistency.

​

🇳🇴 Norway

• Added establishment IDs - Enhanced establishments data by adding proper unique identifiers, improving data structure and referencing capabilities.

​

🇩🇪 Germany

• Fixed company status for cached requests - Resolved an issue where company status might be returned as unknown when retrieving cached company data, ensuring accurate status information.

​

🇵🇹 Portugal

• Restored document retrieval - Fixed document access functionality after adapting to changes in the Portuguese registry’s retrieval workflow, ensuring reliable document retrieval for Portuguese companies.

​

Platform

We are progressively rolling out these data model enhancements to our supported countries, depending on the availability of data in the currently connected registries. This means that not all enhancements may be available for every country immediately, but coverage will expand as registry data allows.

• Establishments - Now you can retrieve all establishments associated with a company, including branch offices, subsidiaries, and other affiliated locations that operate under the parent company’s legal identity. This helps you understand a company’s physical presence and operational footprint.

• Other Key People - Introducing a new data point to capture important company personnel beyond legal representatives. This includes board members, auditors, commissioners, and other significant roles. Unlike legal representatives who have binding authority, Other Key People provides visibility into the broader governance and oversight structure of a company.

• Phone Numbers - Companies can now include multiple phone numbers in E.164 format (e.g., +33123456789), making it easier to establish contact through official channels.

• Website - Retrieve the official company website URL directly from the API response, providing quick access to the company’s online presence.

• Status Details (Beta) - We’re introducing statusDetailsBeta, which provides enriched information about company status changes, including closure reasons, liquidation details, and important dates. The data model for status details is highly likely to evolve as we gather feedback and adapt to the diversity of registry data. As this feature is in beta, we’re actively collecting feedback to refine the data structure and ensure it meets your needs.

• Semaphore Standard Roles Revision - The roles in Semaphore Standard for legal representatives have been revised to cover a broader range of situations and to ensure there is no overlap with Other Key People. This provides clearer, more accurate role classification across jurisdictions.

​

Countries

​

🇳🇴 Norway

• Initial support for Norway - We’re excited to announce support for Norwegian companies, with our integration of the Norwegian Business Registry (Brønnøysundregistrene)! Currently available data points:
  • companyProfile - Access comprehensive company information, legal representatives, other key people and establishments from the Norwegian Business Registry (Brønnøysundregistrene)
  • trade_register_extract - Access official PDF extract, providing comprehensive company information including all registered data, roles, and establishments. Available in English.

​

Platform

• Extended data model to include establishment logic, enhancing our ability to capture and process subsidiary and branch office information across all supported countries.
• New values in Semaphore Standard for roles

​

Countries

​

🇫🇷 France

• Added establishments support, enabling retrieval of subsidiary and branch office information for French companies.
• Fixed UBO parsing, improving accuracy and reliability of Ultimate Beneficial Owner data extraction.

​

Countries

​

🇫🇷 France

• Fixed access to UBO extract, ensuring reliable retrieval of Ultimate Beneficial Owner information.

​

Platform

• Enhanced financial statement metadata quality for availableDocuments, improving accuracy and consistency of document classification and information retrieval.

​

Countries

​

🇪🇸 Spain

• Improved document retrieval system with enhanced robustness and significantly faster processing times, ensuring more reliable access to Spanish company documents.

​

Countries

​

🇳🇱 Netherlands

• Fixed document retrieval and companyProfile to adapt to recent changes on the KVK website, restoring full functionality for Dutch company data access.

​

🇭🇰 Hong Kong

• Restored companyProfile and registerExtract functionality and significantly improved system robustness for Hong Kong data retrieval.

​

Platform

• Company Detention Tree (Beta) - Introducing graphBeta, a new datapoint that allows you to retrieve the complete detention tree of a company. This feature helps visualize company ownership structures and can assist in identifying potential Ultimate Beneficial Owners (UBOs). To use this feature, simply include the “graphBeta” datapoint in your API calls.

​

Countries

​

🇩🇪 Germany

• Enhanced detention tree reconstruction by incorporating control statements from Register Extract documents, enabling more accurate ownership structure analysis.

​

Countries

​

🇪🇸 Spain

• Improved robustness and scalability of data processing systems, enhancing overall performance and reliability of Spanish company data retrieval.

​

🇨🇳 China

• Enhanced error handling for cases where company is not found but registry is accessible, providing clearer feedback and improved user experience.

​

🇬🇧 United Kingdom

• Enhanced error handling for cases where companies are not found in the registry, providing more informative and user-friendly error messages.

​

🇩🇪 Germany

• Improved shareholder data extraction from documents, adding support for rotated document processing.

​

Countries

​

🇩🇪 Germany

• Enhanced robustness of shareholders computation system, improving reliability and accuracy of ownership data processing.

​

🇪🇸 Spain

• Improved system resilience for document access and retrieval, implementing additional error handling and recovery mechanisms.

​

Platform

• Implemented embedding cache system for standardized activity codes, legal forms, and roles processing, saving up to 1.5 second of processing time per query.
• Fixed error handling for cases when companies are not found, eliminating 500 errors. Users now see a generic “An Error has occurred in the job status” message. We’re working on improving generic error messages.

​

Countries

​

🇩🇪 Germany

• Major Update: Shareholders now derived from Gesellschafterliste. This is preliminary work to enable detention tree reconstruction and UBO identification in Germany. Coming soon!
• Improved robustness of company data retrieval by implementing additional error handling and fallback mechanisms.
• Improved parsing of shareholders data, enhancing accuracy and completeness of ownership information.
• Improved handling of german id including parenthesis.

​

🇬🇧 United Kingdom

• Fixed Register Extract functionality to adapt to the new Companies House website flow, ensuring reliable document retrieval.

​

Platform

• Fixed error handling for cases when companies are not found, eliminating 500 errors. Users now see a generic “An Error has occurred in the job status” message. We’re working on improving generic error messages.

​

Countries

​

🇪🇸 Spain

• Fixed financial document listing functionality to correctly retrieve and display available financial documents.

​

Platform

• Optimized request processing pipeline, resulting in an average 2 seconds reduction in response time across all endpoints.
• Fixed performance bottlenecks when processing companies with large document collections by implementing a faster inference endpoint for document metadata processing.
• Enhanced performance logging across the application to better identify and address bottlenecks.

​

Countries

​

🇮🇹 Italy

• Added support for asynchronous data retrieval from the Italian Chamber of Commerce (Camerale). As a result, companyProfile for Italy is now an asynchronous data point.

​

🇩🇪 Germany

• Implemented fallback to Handelsregister when Unternehmensregister is unavailable for search and companyProfile.

​

🇪🇸 Spain

• Improved overall speed and reliability of Spanish company data retrieval through infrastructure optimizations.
• Added support for asynchronous data retrieval for legalRepresentatives in Spain. Note that base companyProfile data still remains synchronous. This change prevents blocking access to base company data when fetching many legal representatives, which could be time-consuming for companies with extensive representative lists.
• As a result, companyProfile for Spain is now a partially asynchronous data point.

​

🇨🇳 China

• Improved overall speed and reliability of Chinese company data retrieval through infrastructure optimizations.

​

🇳🇱 Netherlands

• Updated document listing functionality to match KVK’s new API specifications, restoring the ability to list available documents for Dutch companies.