curl --request GET \
--url https://api.topograph.co/v2/search \
--header 'x-api-key: <api-key>'import requests
url = "https://api.topograph.co/v2/search"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.topograph.co/v2/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.topograph.co/v2/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.topograph.co/v2/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.topograph.co/v2/search")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.topograph.co/v2/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"address": {
"addressLine1": "10 rue de la Fraternité",
"addressLine2": "Topograph Building",
"city": "Bagnolet",
"postalCode": "93170",
"region": "FR",
"countryCode": "FR",
"poBox": "PO Box 123",
"careOf": "c/o John Doe",
"state": "Île-de-France",
"latitude": 59.9139,
"longitude": 10.7522
},
"id": "932884117",
"legalName": "SEMAPHORE",
"countryCode": "FR",
"matchReason": {
"matchType": "default"
},
"legalNameInEnglish": "Test Display Hong Kong Trading Limited",
"companyNameTransliterations": [
"Naftogaz",
"Naftohaz"
]
}
]{
"statusCode": 400,
"error": {
"code": "invalid_request",
"message": "Query is too short. Please provide at least 2 characters for company name search",
"details": [
"Query must be at least 2 characters"
]
}
}{
"statusCode": 500,
"error": {
"code": "service_unavailable",
"message": "An error occurred while searching. Please try again later."
}
}Search for companies
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. A Legal Entity Identifier (LEI) is accepted as the query in every country and returns the company it designates.
Standard Mode (stream=false or omitted): Returns JSON array of results once all search sources have completed.
Streaming Mode (stream=true): Returns Server-Sent Events (SSE) with progressive results as each search source completes. The endpoint emits named events:
progress: Partial results from completed sourcescomplete: Final results when all sources finisherror: If the search fails
Streaming is beneficial for countries with multiple search sources (e.g., Germany queries both Unternehmensregister and Handelsregister), providing faster time-to-first-result.
Response times vary by country: from sub-second to up to 10 seconds.
curl --request GET \
--url https://api.topograph.co/v2/search \
--header 'x-api-key: <api-key>'import requests
url = "https://api.topograph.co/v2/search"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.topograph.co/v2/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.topograph.co/v2/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.topograph.co/v2/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.topograph.co/v2/search")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.topograph.co/v2/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"address": {
"addressLine1": "10 rue de la Fraternité",
"addressLine2": "Topograph Building",
"city": "Bagnolet",
"postalCode": "93170",
"region": "FR",
"countryCode": "FR",
"poBox": "PO Box 123",
"careOf": "c/o John Doe",
"state": "Île-de-France",
"latitude": 59.9139,
"longitude": 10.7522
},
"id": "932884117",
"legalName": "SEMAPHORE",
"countryCode": "FR",
"matchReason": {
"matchType": "default"
},
"legalNameInEnglish": "Test Display Hong Kong Trading Limited",
"companyNameTransliterations": [
"Naftogaz",
"Naftohaz"
]
}
]{
"statusCode": 400,
"error": {
"code": "invalid_request",
"message": "Query is too short. Please provide at least 2 characters for company name search",
"details": [
"Query must be at least 2 characters"
]
}
}{
"statusCode": 500,
"error": {
"code": "service_unavailable",
"message": "An error occurred while searching. Please try again later."
}
}Authorizations
Query Parameters
The country code in ISO 3166-1 alpha-2 format (e.g., "FR" for France, "DE" for Germany).
AT, BE, BG, CH, CN, CZ, CY, DE, DK, EE, ES, FI, FR, GB, GG, GR, HK, HR, HU, IE, IS, IT, JE, LI, LU, LV, MC, MT, MU, NL, NO, PL, PT, RO, RU, SE, SG, SI, SK, VG, PA, MX, CO, EC, BM, AR, AG, BA, BR, GI, IM, KY, US-FL, US-CO, US-IL, US-MA, US-MD, US-MI, US-TX, US-DE, UA, US-NY, US-NJ, US-NM, US-OH, US-WA, US-TN, US-GA, US-MN, US-MO, US-NV, RS, US-PA, US-WY, US-CT, US-UT, US-IA, US-ID, US-AZ, US-VA, US-MS, US-CA, US-OR, US-KY, US-NE, US-NC, US-AR, US-WI, US-SC, US-AL, US-AK, US-DC, US-IN, US-ME, US-MT, US-OK, US-SD, US-LA, US-WV, US-ND, US-VT, US-KS, US-RI, US-HI, LT, MD, MH, US-NH, CA-FED, CA-ON, CA-QC, CA-BC, CA-AB, CA-MB, CA-SK, CA-NS, CA-NL, CA-PE, CA-YT, CA-NT, NC, PF "FR"
The search query, which can be a company name, a registration number or an LEI. Note that search capabilities may vary by country, with some supporting only name or registration number searches. An LEI (Legal Entity Identifier, 20 characters) is recognised in every country: it returns the company the LEI designates, under its registration number, or nothing. The LEI decides where that company is registered, so the result can carry another countryCode than the country requested.
"Topograph"
Enable streaming mode. When true, returns Server-Sent Events (SSE) with progressive results as each search source completes. Set Accept header to "text/event-stream" for proper streaming. When false or omitted, returns standard JSON array after all sources complete.
true
When true, only companies the register reports as active are returned: dissolved, struck-off, deregistered and otherwise inactive companies are excluded. A company whose status the search source does not report is kept rather than hidden. Whether a country's search can return inactive companies at all, and how completely this filter applies there, is published per country in the catalog under search. When false or omitted, results are not filtered on status.
true
When true, returns only results explicitly reported as active and excludes unknown statuses. Implies activeOnly. Status freshness depends on the search source; this does not request a new company verification.
false
When true, user-facing string fields in the response (company names, addresses, person names, activity descriptions) are romanized from their native script to Latin characters on the way out. Internal data, cache, and billing are unaffected — only the response payload is transformed. Routing: Cyrillic/Greek/Hangul/Hebrew/Arabic/Thai via unidecode, Chinese via pinyin-pro (toneless), Japanese via kuroshiro (Hepburn).
false
Response
List of companies (JSON when stream=false, SSE when stream=true)
The legal address of the company
Show child attributes
Show child attributes
The company number. In some countries, this might be a concatenation of the registry and city (e.g., in Germany: "Augsburg HRB 34617"). The search function will always return a usable company number. Check the documentation to see which number format is used for each country.
"932884117"
Legal name of the company
"SEMAPHORE"
The country code in ISO 3166-1 alpha-2 format (e.g., "FR" for France, "DE" for Germany).
AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BQ, BA, BW, BV, BR, IO, BN, BG, BF, BI, KH, CM, CA, CA-FED, CA-ON, CA-QC, CA-BC, CA-AB, CA-MB, CA-SK, CA-NS, CA-NB, CA-NL, CA-PE, CA-YT, CA-NT, CA-NU, CV, KY, CF, TD, CL, CN, CX, CC, CO, KM, CG, CD, CK, CR, CI, HR, CU, CW, CY, CZ, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, DE-SCHUFA, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HK, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KR, KP, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MO, MK, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, MX, FM, MD, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, MP, NO, OM, PK, PW, PS, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, RE, RO, RU, RW, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, GS, SS, ES, LK, SD, SR, SJ, SZ, SE, CH, SY, TW, TJ, TZ, TH, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, US, UM, UY, UZ, VU, VE, VN, VG, VI, WF, EH, YE, ZM, ZW, US-FL, US-CO, US-IL, US-MA, US-MD, US-MI, US-NJ, US-NM, US-NY, US-OH, US-TX, US-DE, US-WA, US-AL, US-TN, US-WY, US-GA, US-MN, US-MO, US-NV, US-PA, US-CT, US-UT, US-IA, US-ID, US-AZ, US-VA, US-MS, US-CA, US-OR, US-KY, US-NE, US-NC, US-AR, US-WI, US-SC, US-AK, US-DC, US-IN, US-ME, US-MT, US-OK, US-SD, US-LA, US-WV, US-ND, US-VT, US-KS, US-RI, US-HI, US-NH, TEST "FR"
Match reason containing information about why this result was returned. Includes the match type and which identifier matched for ID matches.
Show child attributes
Show child attributes
{ "matchType": "default" }
The English translation or romanization of the legal name, commonly used for international business. Particularly relevant for companies registered with non-Latin alphabet names (e.g., Chinese, Japanese, Korean, etc.).
"Test Display Hong Kong Trading Limited"
Deterministic Latin transliterations of the company name, computed using per-country standards (e.g. UA: GOST + KMU 55 + ISO 9). Useful for displaying alternative Latin spellings alongside the original-script legalName. Absent or empty for Latin-script companies and for non-Latin countries not yet covered.
["Naftogaz", "Naftohaz"]