Skip to main content
POST
Get locations in batch

Authorizations

Authorization
string
header
required

An API key issued by The Data City, sent as: Authorization: Bearer YOUR_KEY

Body

Response

OK

CompanyNumber
string | null
required

Unique company identifier from the data source for this location

Name
string | null

Official company name for this location

Website
string | null

Company website URL for this location

Description
string | null

Business description or summary of activities for this location

Country
string | null

Country where this location is registered (defaults to "USA")

Address
string | null

Street address of this specific location

Town
string | null

City or town where this location is situated

State
string | null

US state where this location is registered

Phone
string | null

Primary business phone number for this location

RegNumber
string | null

Official registration number for this location (e.g., EIN, state registration)

Zipcode
string | null

US postal code (ZIP code) for this location

Latitude
number<double> | null

Latitude of the location

Longitude
number<double> | null

Longitude of the location

Legal form of business entity for this location (e.g., Corporation, LLC, Partnership)

EmployeeRange
string | null

Employee count range for this specific location (e.g., "1-10", "11-50", "51-200")

Employees
integer<int32> | null

Exact number of employees at this location

Turnover
integer<int64> | null

Annual revenue/turnover for this specific location in US dollars

FinancesByYear
object[] | null

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.

LogoURL
string | null

Resolved logo URL derived from website (populated after loading from DuckDB).

ParentCompanyNumber
string | null

Parent company number when this row is a location tied to a parent entity.

ParentCompanyName
string | null

Parent company display name when TDC_Global_Server_API_US.Models.ProcessedCompanyLocation.ParentCompanyNumber is set.

ActivityCode
string | null

Primary NAICS code for this location (Infobel LocalCode01).

ActivityCodeName
string | null

Display name for TDC_Global_Server_API_US.Models.ProcessedCompanyLocation.ActivityCode (Infobel LocalLabel01, else NAIC-Codes lookup).

SicCode
string | null

Standard Industrial Classification code for this location (Infobel InternationalCode01).

SicCodeName
string | null

Display name for TDC_Global_Server_API_US.Models.ProcessedCompanyLocation.SicCode (Infobel InternationalLabel01).

NAICS
string[] | null

List of NAIC codes describing the operations at this location. Wire name NAICS.

Last modified on July 30, 2026