curl --request GET \
--url https://global-api.thedatacity.com/v1/us/companies/{companyNumber} \
--header 'Authorization: Bearer <token>'import requests
url = "https://global-api.thedatacity.com/v1/us/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/us/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/us/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/us/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/us/companies/{companyNumber}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://global-api.thedatacity.com/v1/us/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>",
"Address": "<string>",
"Town": "<string>",
"State": "<string>",
"Phone": "<string>",
"RegNumber": "<string>",
"Zipcode": "<string>",
"Latitude": 123,
"Longitude": 123,
"CompaniesInGroup": [
{
"CompanyNumber": "<string>",
"Name": "<string>",
"Website": "<string>",
"Description": "<string>",
"Country": "<string>",
"Address": "<string>",
"Town": "<string>",
"State": "<string>",
"Phone": "<string>",
"RegNumber": "<string>",
"Zipcode": "<string>",
"Latitude": 123,
"Longitude": 123,
"LegalForm": "<string>",
"EmployeeRange": "<string>",
"Employees": 123,
"Turnover": 123,
"FinancesByYear": [
{
"YearEnding": 123,
"AccountsDate": "2023-12-25",
"AccountsType": "<string>",
"Turnover": 123,
"EBIT": 123,
"NetIncome": 123,
"EmployeesHere": 123,
"EmployeesTotal": 123
}
],
"LogoURL": "<string>",
"ParentCompanyNumber": "<string>",
"ParentCompanyName": "<string>",
"ActivityCode": "<string>",
"ActivityCodeName": "<string>",
"SicCode": "<string>",
"SicCodeName": "<string>",
"NAICS": [
"<string>"
]
}
],
"Employees": 123,
"EmployeesTotal": 123,
"Turnover": 123,
"FinancesByYear": [
{
"YearEnding": 123,
"AccountsDate": "2023-12-25",
"AccountsType": "<string>",
"Turnover": 123,
"EBIT": 123,
"NetIncome": 123,
"EmployeesHere": 123,
"EmployeesTotal": 123
}
],
"BestEstimateGrowthPercentagePerYear": 123,
"Directors": [
{
"FirstName": "<string>",
"LastName": "<string>",
"FullName": "<string>",
"LocalPnr": "<string>",
"DateOfBirth": "2023-12-25",
"DateOfChange": "2023-12-25",
"Active": true,
"Position": "<string>",
"Gender": "<string>",
"Language": "<string>"
}
],
"ActivityCode": "<string>",
"ActivityCodeName": "<string>",
"SicCode": "<string>",
"SicCodeName": "<string>",
"NAICS": [
"<string>"
],
"RNAICS": [
{
"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/us/companies/{companyNumber} \
--header 'Authorization: Bearer <token>'import requests
url = "https://global-api.thedatacity.com/v1/us/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/us/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/us/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/us/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/us/companies/{companyNumber}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://global-api.thedatacity.com/v1/us/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>",
"Address": "<string>",
"Town": "<string>",
"State": "<string>",
"Phone": "<string>",
"RegNumber": "<string>",
"Zipcode": "<string>",
"Latitude": 123,
"Longitude": 123,
"CompaniesInGroup": [
{
"CompanyNumber": "<string>",
"Name": "<string>",
"Website": "<string>",
"Description": "<string>",
"Country": "<string>",
"Address": "<string>",
"Town": "<string>",
"State": "<string>",
"Phone": "<string>",
"RegNumber": "<string>",
"Zipcode": "<string>",
"Latitude": 123,
"Longitude": 123,
"LegalForm": "<string>",
"EmployeeRange": "<string>",
"Employees": 123,
"Turnover": 123,
"FinancesByYear": [
{
"YearEnding": 123,
"AccountsDate": "2023-12-25",
"AccountsType": "<string>",
"Turnover": 123,
"EBIT": 123,
"NetIncome": 123,
"EmployeesHere": 123,
"EmployeesTotal": 123
}
],
"LogoURL": "<string>",
"ParentCompanyNumber": "<string>",
"ParentCompanyName": "<string>",
"ActivityCode": "<string>",
"ActivityCodeName": "<string>",
"SicCode": "<string>",
"SicCodeName": "<string>",
"NAICS": [
"<string>"
]
}
],
"Employees": 123,
"EmployeesTotal": 123,
"Turnover": 123,
"FinancesByYear": [
{
"YearEnding": 123,
"AccountsDate": "2023-12-25",
"AccountsType": "<string>",
"Turnover": 123,
"EBIT": 123,
"NetIncome": 123,
"EmployeesHere": 123,
"EmployeesTotal": 123
}
],
"BestEstimateGrowthPercentagePerYear": 123,
"Directors": [
{
"FirstName": "<string>",
"LastName": "<string>",
"FullName": "<string>",
"LocalPnr": "<string>",
"DateOfBirth": "2023-12-25",
"DateOfChange": "2023-12-25",
"Active": true,
"Position": "<string>",
"Gender": "<string>",
"Language": "<string>"
}
],
"ActivityCode": "<string>",
"ActivityCodeName": "<string>",
"SicCode": "<string>",
"SicCodeName": "<string>",
"NAICS": [
"<string>"
],
"RNAICS": [
{
"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 US 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")
Street address of the company headquarters
City or town where the company is located
US state where the company is registered
Primary business phone number
Official registration number (e.g., EIN, state registration)
US postal code (ZIP code)
Latitude of the company
Longitude of the company
List of subsidiary companies or business locations within the corporate group
Show child attributes
Show child attributes
Exact number of employees at this site (Infobel EmployeesHere).
Total employees across the organisation (Infobel EmployeesTotal).
Annual revenue/turnover in US dollars
Annual financial history snapshots (year ending, employees, turnover). Wire name FinancesByYear.
Show child attributes
Show child attributes
Best estimate of annual turnover growth percentage (OLS over financial history; null when fewer than three valid years).
Directors and executives from Infobel Exec01–11 (CEO appended only when not already listed). Shared TDC_Global_Server_API_Core.Models.CompanyDirector wire shape.
Show child attributes
Show child attributes
Primary NAICS code for the parent entity (Infobel LocalCode01). The full distinct union across the group remains in TDC_Global_Server_API_US.Models.ProcessedCompany.NAICs.
Display name for TDC_Global_Server_API_US.Models.ProcessedCompany.ActivityCode (Infobel LocalLabel01, else NAIC-Codes lookup).
Standard Industrial Classification code (Infobel InternationalCode01).
Display name for TDC_Global_Server_API_US.Models.ProcessedCompany.SicCode (Infobel InternationalLabel01).
List of NAIC codes describing the company's operations. Wire name NAICS.
RNAIC (industry classification) data associated with the company. Wire name RNAICS.
Show child attributes
Show child attributes
Similar companies to the current company
Show child attributes
Show child attributes