🇬🇧 United Kingdom

🇩🇪 Germany

🇮🇹 Italy

🇵🇱 Poland

Supported Countries

Country Specifics

Semaphore

Welcome to Semaphore's Official API Documentation

Introduction

Search for a company

Retrieve company data

Pricing & Caching

Search for companies

Get pricing for a country

Stay updated with the latest changes and improvements to Semaphore

Changelog

Welcome to the home of Semaphore's documentation

Webhooks Configuration

Understanding the different type of registration numbers used by Semaphore

Company registration numbers

Coverage map

This endpoint allows you to search for companies based on a country code and a query string.

The search can be performed using either a company legal name, commercial name, historical name, or registration number. Capabilities vary by country. 

The results include basic company information such as name, address, and the id of the company. You can pass this id to the getCompany endpoint to retrieve more detailed information about the company.

Depending on the country, the speed might vary, from sub-second results, up to 10 seconds.

This endpoint allows you to retrieve detailed information about a specific company.

You can either:
1. Make a new request by providing:
   - country code
   - company id
   - desired data points
   - optional document IDs

2. Get results from a previous request by providing:
   - requestId (this will return cached data and avoid being billed again)

Available data points are:
- companyProfile: Basic company information, legal representatives and shareholders
- ultimateBeneficialOwners: Information about beneficial owners
- availableDocuments: List of available official documents

There are two ways to retrieve documents:

1. Two-step process:
   - First, request the "availableDocuments" data point to get a list of all available documents with their IDs
   - Then, use these specific document IDs in a second request

2. Direct access using smart IDs:
   - Use predefined smart IDs for quick access to common documents:
     - trade_register_extract: Latest trade register extract
     - certified_trade_register_extract: Latest certified trade register extract
     - last_fiscal_year_financial_statement: Latest financial statement
     - last_consolidated_article_of_association: Latest consolidated articles of association

Refer to our country coverage documentation to check which smart IDs are available for each country.

Generate a short-lived link for the webhook management portal.

Get Started

Essentials

Country Specifics

Supported Countries

🇬🇧 United Kingdom

🇩🇪 Germany

🇮🇹 Italy

🇵🇱 Poland

Get Started

Essentials

​Supported Countries

​🇬🇧 United Kingdom

​🇩🇪 Germany

​🇮🇹 Italy

​🇵🇱 Poland

Supported Countries

🇬🇧 United Kingdom

🇩🇪 Germany

🇮🇹 Italy

🇵🇱 Poland