Skip to main content
POST

Authorizations

Authorization
string
header
required

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

Body

The body is of type any.

Response

OK

CompanyNumber
string
required

Unique company identifier from the data source

Minimum string length: 1
Description
string | null

Company description or business activity summary

Legal form of the company

EmployeeRange
string | null

Employee count range bucket label

RTICs
object[] | null

Real-Time Industrial Classifications (RTIC) associated with the company.

LogoURL
string | null

URL of the company logo

ScreenshotURL
string | null

URL of the company screenshot

OperatingLocationsCount
integer<int32> | null

Number of operating or group locations stored on the company row (without returning the full list).

Name
string | null

Official company name

Website
string | null
Country
string | null

Country where the company is registered.

OrgNumber
string | null

Handelsregister number from Creditsafe (org_number). Prefer this for UI display and website verification. Not unique without a court qualifier.

RegistrationNumber
string | null

Handelsregister number from Creditsafe (reg_number).

VATNumber
string | null

German VAT identification number from Creditsafe (vat_number).

HQAddress
string | null

Headquarters address

HQPostcode
string | null

Headquarters postal code

HQPostcodeDetails
object

Model representing a Germany address

Address
string | null

Street address of the company headquarters

Town
string | null

City or town where the company is located

State
string | null

State where the company is registered

Phone
string | null

Primary business phone number

Zipcode
string | null

Postal code for the company

Latitude
number<double> | null

Latitude of the company

Longitude
number<double> | null

Longitude of the company

DateOfIncorporation
string<date> | null

Date when the company was incorporated

BestEstimateCurrentEmployees
integer<int32> | null

Best estimate of current employees from source enrichment.

BestEstimateCurrentTurnover
number<double> | null

Best estimate of current turnover from source enrichment.

Turnover
integer<int64> | null

Annual revenue/turnover value (materialised in DuckDB from Creditsafe latest turnover / finances).

TurnoverBand
string | null

Turnover band label for bucketing/reporting.

BestEstimateGrowthPercentagePerYear
number<double> | null

Best estimate growth percentage per year.

FinancesByYear
object[] | null

Annual financial snapshots for this company.

Directors
object[] | null

Directors associated with this company (German Creditsafe shape: shared fields plus address).

Company growth trend classification label/value.

WZs
string[] | null

Primary industry classification rows associated with the company

RWZs
object[] | null

Secondary industry classification rows associated with the company

OECDScaleup
boolean

OECD scaleup indicator.

SimilarCompanies
object[] | null

Similar companies to the current company

Last modified on July 30, 2026