curl --request GET \
--url https://global-api.thedatacity.com/v1/ie/companies/{companyNumber} \
--header 'Authorization: Bearer <token>'import requests
url = "https://global-api.thedatacity.com/v1/ie/companies/{companyNumber}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://global-api.thedatacity.com/v1/ie/companies/{companyNumber}', 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://global-api.thedatacity.com/v1/ie/companies/{companyNumber}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://global-api.thedatacity.com/v1/ie/companies/{companyNumber}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://global-api.thedatacity.com/v1/ie/companies/{companyNumber}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://global-api.thedatacity.com/v1/ie/companies/{companyNumber}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"CompanyNumber": "<string>",
"Description": "<string>",
"LegalForm": "<string>",
"EmployeeRange": "<string>",
"RTICs": [
{
"CompanyNumber": "<string>",
"SectorCode": "<string>",
"SectorName": "<string>",
"VerticalCode": "<string>",
"VerticalName": "<string>",
"Score": 123,
"WordsMatched": 123,
"Name": "<string>"
}
],
"LogoURL": "<string>",
"ScreenshotURL": "<string>",
"OperatingLocationsCount": 123,
"Name": "<string>",
"Website": "<string>",
"Country": "<string>",
"HQAddress": "<string>",
"HQPostcode": "<string>",
"HQPostcodeDetails": {
"DepartmentName": "<string>",
"OrganisationName": "<string>",
"SubBuildingName": "<string>",
"BuildingName": "<string>",
"POBoxNumber": "<string>",
"BuildingNumber": "<string>",
"BuildingGroup": "<string>",
"DependentStreet": "<string>",
"MainStreet": "<string>",
"DoubleDependentLocality": "<string>",
"DependentLocality": "<string>",
"PostTown": "<string>",
"County": "<string>",
"Postcode": "<string>",
"Latitude": 123,
"Longitude": 123
},
"Address": "<string>",
"Town": "<string>",
"State": "<string>",
"Phone": "<string>",
"Zipcode": "<string>",
"Latitude": 123,
"Longitude": 123,
"Employees": 123,
"Turnover": 123,
"NACEs": [
"<string>"
],
"RNACEs": [
{
"CompanyNumber": "<string>",
"Code": "<string>",
"Name": "<string>",
"Score": 123
}
],
"SimilarCompanies": [
{
"CompanyNumber": "<string>",
"SimilarityScore": 123
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}Get a company
Returns a single company as host-defined JSON.
curl --request GET \
--url https://global-api.thedatacity.com/v1/ie/companies/{companyNumber} \
--header 'Authorization: Bearer <token>'import requests
url = "https://global-api.thedatacity.com/v1/ie/companies/{companyNumber}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://global-api.thedatacity.com/v1/ie/companies/{companyNumber}', 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://global-api.thedatacity.com/v1/ie/companies/{companyNumber}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://global-api.thedatacity.com/v1/ie/companies/{companyNumber}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://global-api.thedatacity.com/v1/ie/companies/{companyNumber}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://global-api.thedatacity.com/v1/ie/companies/{companyNumber}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"CompanyNumber": "<string>",
"Description": "<string>",
"LegalForm": "<string>",
"EmployeeRange": "<string>",
"RTICs": [
{
"CompanyNumber": "<string>",
"SectorCode": "<string>",
"SectorName": "<string>",
"VerticalCode": "<string>",
"VerticalName": "<string>",
"Score": 123,
"WordsMatched": 123,
"Name": "<string>"
}
],
"LogoURL": "<string>",
"ScreenshotURL": "<string>",
"OperatingLocationsCount": 123,
"Name": "<string>",
"Website": "<string>",
"Country": "<string>",
"HQAddress": "<string>",
"HQPostcode": "<string>",
"HQPostcodeDetails": {
"DepartmentName": "<string>",
"OrganisationName": "<string>",
"SubBuildingName": "<string>",
"BuildingName": "<string>",
"POBoxNumber": "<string>",
"BuildingNumber": "<string>",
"BuildingGroup": "<string>",
"DependentStreet": "<string>",
"MainStreet": "<string>",
"DoubleDependentLocality": "<string>",
"DependentLocality": "<string>",
"PostTown": "<string>",
"County": "<string>",
"Postcode": "<string>",
"Latitude": 123,
"Longitude": 123
},
"Address": "<string>",
"Town": "<string>",
"State": "<string>",
"Phone": "<string>",
"Zipcode": "<string>",
"Latitude": 123,
"Longitude": 123,
"Employees": 123,
"Turnover": 123,
"NACEs": [
"<string>"
],
"RNACEs": [
{
"CompanyNumber": "<string>",
"Code": "<string>",
"Name": "<string>",
"Score": 123
}
],
"SimilarCompanies": [
{
"CompanyNumber": "<string>",
"SimilarityScore": 123
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}Authorizations
An API key issued by The Data City, sent as: Authorization: Bearer YOUR_KEY
Path Parameters
Query Parameters
Response
OK
Processed company data with comprehensive business information
Unique company identifier from the data source
1Company description or business activity summary
Legal form of the company
Employee count range bucket label
Real-Time Industrial Classifications (RTIC) associated with the company.
Show child attributes
Show child attributes
URL of the company logo
URL of the company screenshot
Number of operating or group locations stored on the company row (without returning the full list).
Official company name
Country where the company is registered (defaults to "USA")
Headquarters address
Headquarters postal code
Model representing a Germany address
Show child attributes
Show child attributes
Street address of the company headquarters
City or town where the company is located
State where the company is registered
Primary business phone number
Postal code for the company
Latitude of the company
Longitude of the company
Exact number of employees
Annual revenue/turnover value
Primary industry classification rows associated with the company
Secondary industry classification rows associated with the company
Show child attributes
Show child attributes
Similar companies to the current company
Show child attributes
Show child attributes