curl --request GET \
--url https://global-api.thedatacity.com/v1/us/companies/location/{companyNumber} \
--header 'Authorization: Bearer <token>'import requests
url = "https://global-api.thedatacity.com/v1/us/companies/location/{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/location/{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/location/{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/location/{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/location/{companyNumber}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://global-api.thedatacity.com/v1/us/companies/location/{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>",
"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>"
]
}{
"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 company locations
Returns one operating-location record as JSON, or 404.
curl --request GET \
--url https://global-api.thedatacity.com/v1/us/companies/location/{companyNumber} \
--header 'Authorization: Bearer <token>'import requests
url = "https://global-api.thedatacity.com/v1/us/companies/location/{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/location/{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/location/{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/location/{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/location/{companyNumber}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://global-api.thedatacity.com/v1/us/companies/location/{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>",
"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>"
]
}{
"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
Response
OK
Operating location information for a company
Unique company identifier from the data source for this location
Official company name for this location
Company website URL for this location
Business description or summary of activities for this location
Country where this location is registered (defaults to "USA")
Street address of this specific location
City or town where this location is situated
US state where this location is registered
Primary business phone number for this location
Official registration number for this location (e.g., EIN, state registration)
US postal code (ZIP code) for this location
Latitude of the location
Longitude of the location
Legal form of business entity for this location (e.g., Corporation, LLC, Partnership)
Employee count range for this specific location (e.g., "1-10", "11-50", "51-200")
Exact number of employees at this location
Annual revenue/turnover for this specific location in US dollars
Annual financial history snapshots for this location (wire name FinancesByYear).
DuckDB nested struct still uses Financials; TDC_Global_Server_API_US.Models.ProcessedCompanyLocation.Financials maps into this.
Show child attributes
Show child attributes
Resolved logo URL derived from website (populated after loading from DuckDB).
Parent company number when this row is a location tied to a parent entity.
Parent company display name when TDC_Global_Server_API_US.Models.ProcessedCompanyLocation.ParentCompanyNumber is set.
Primary NAICS code for this location (Infobel LocalCode01).
Display name for TDC_Global_Server_API_US.Models.ProcessedCompanyLocation.ActivityCode (Infobel LocalLabel01, else NAIC-Codes lookup).
Standard Industrial Classification code for this location (Infobel InternationalCode01).
Display name for TDC_Global_Server_API_US.Models.ProcessedCompanyLocation.SicCode (Infobel InternationalLabel01).
List of NAIC codes describing the operations at this location. Wire name NAICS.