This endpoint allows you to retrieve the pricing information for a specific country.

The response includes:
- Base price for company searches
- Pricing for different data points (company profile, UBO, etc.)
- Document retrieval costs
- Any country-specific pricing variations

This can be useful for:
- Understanding costs before making requests
- Budgeting and planning purposes
- Displaying pricing information to end users

Note: Prices are returned in euros (EUR) and may vary based on your subscription plan.

Get pricing for a country

x api key

Semaphore

Welcome to Semaphore's Official API Documentation

Introduction

Search for a company

Retrieve company data

Country Specifics

Pricing & Caching

Search for companies

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.

App

Get pricing for a country

Authorizations

Body

Response