Skip to main content
GET
Get a company

Authorizations

Authorization
string
header
required

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

Path Parameters

companyNumber
string
required

Query Parameters

includesLocations
boolean
default:false

Response

OK

Processed French company data with comprehensive business information

Siren
string
required

Unique company identifier (French SIREN). Serialized as Siren in JSON for the France API.

Minimum string length: 1
Name
string
required

Official company name

Minimum string length: 1
Website
string | null

Company website URL. Hosts may override (e.g. normalise casing).

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).

Country
string | null

Country where the company is registered

CommonName
string | null

Common or trading name of the company

Acronym
string | null

Company acronym or abbreviation

HQAddress
string | null

Headquarters address

HQPostcode
string | null

Headquarters postal code

HQPostcodeDetails
object

Details about a French postal code including commune and geographic information

HQCommune
string | null

Commune (municipality) name for the headquarters postcode

DateOfIncorporation
string<date> | null

Date when the company was incorporated

NAFSection
string | null

NAF section (French business activity classification)

NAFCodes
string[] | null

NAF codes from Parquet (list column NAFCodes).

NAFCode
string | null

Primary NAF code (French business activity classification). Filled from a dedicated NAFCode source column when present; otherwise the first entry of TDC_Global_Server_API_FR.Models.ProcessedCompany.NAFCodes.

NAFName
string | null

Description of the NAF code

OperatingLocations
object[] | null

List of operating locations for the company

FinancesByYear
object[] | null

Annual financial snapshots for this company (wire name FinancesByYear).

SimilarCompanies
object[] | null

Similar companies to the current company

Last modified on July 30, 2026