Get companies in batch - The Data City

[
  {
    "Siren": "<string>",
    "Name": "<string>",
    "Website": "<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,
    "Country": "<string>",
    "CommonName": "<string>",
    "Acronym": "<string>",
    "HQAddress": "<string>",
    "HQPostcode": "<string>",
    "HQPostcodeDetails": {
      "code_commune_INSEE": "<string>",
      "nom_commune_postal": "<string>",
      "code_postal": "<string>",
      "libelle_acheminement": "<string>",
      "ligne_5": "<string>",
      "latitude": 123,
      "longitude": 123,
      "code_commune": "<string>",
      "article": "<string>",
      "nom_commune": "<string>",
      "nom_commune_complet": "<string>",
      "code_departement": "<string>",
      "nom_departement": "<string>",
      "code_region": "<string>",
      "nom_region": "<string>"
    },
    "HQCommune": "<string>",
    "DateOfIncorporation": "2023-12-25",
    "NAFSection": "<string>",
    "NAFCodes": [
      "<string>"
    ],
    "NAFCode": "<string>",
    "NAFName": "<string>",
    "OperatingLocations": [
      {
        "Siret": "<string>",
        "Address": "<string>",
        "Postcode": "<string>",
        "DateEstablished": "2023-12-25",
        "IsRegisteredHQ": true,
        "Commune": "<string>",
        "NAFCode": "<string>",
        "NAFName": "<string>",
        "EmployeeRange": "<string>",
        "Latitude": 123,
        "Longitude": 123,
        "PostcodeDetails": {
          "code_commune_INSEE": "<string>",
          "nom_commune_postal": "<string>",
          "code_postal": "<string>",
          "libelle_acheminement": "<string>",
          "ligne_5": "<string>",
          "latitude": 123,
          "longitude": 123,
          "code_commune": "<string>",
          "article": "<string>",
          "nom_commune": "<string>",
          "nom_commune_complet": "<string>",
          "code_departement": "<string>",
          "nom_departement": "<string>",
          "code_region": "<string>",
          "nom_region": "<string>"
        },
        "ParentCompanyNumber": "<string>",
        "ParentCompanyName": "<string>"
      }
    ],
    "FinancesByYear": [
      {
        "YearEnding": 123,
        "AccountsDate": "2023-12-25",
        "AccountsType": "<string>",
        "Turnover": 123,
        "EBIT": 123,
        "NetIncome": 123,
        "EmployeesHere": 123,
        "EmployeesTotal": 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>"
}

POST

companies

batch

[
  {
    "Siren": "<string>",
    "Name": "<string>",
    "Website": "<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,
    "Country": "<string>",
    "CommonName": "<string>",
    "Acronym": "<string>",
    "HQAddress": "<string>",
    "HQPostcode": "<string>",
    "HQPostcodeDetails": {
      "code_commune_INSEE": "<string>",
      "nom_commune_postal": "<string>",
      "code_postal": "<string>",
      "libelle_acheminement": "<string>",
      "ligne_5": "<string>",
      "latitude": 123,
      "longitude": 123,
      "code_commune": "<string>",
      "article": "<string>",
      "nom_commune": "<string>",
      "nom_commune_complet": "<string>",
      "code_departement": "<string>",
      "nom_departement": "<string>",
      "code_region": "<string>",
      "nom_region": "<string>"
    },
    "HQCommune": "<string>",
    "DateOfIncorporation": "2023-12-25",
    "NAFSection": "<string>",
    "NAFCodes": [
      "<string>"
    ],
    "NAFCode": "<string>",
    "NAFName": "<string>",
    "OperatingLocations": [
      {
        "Siret": "<string>",
        "Address": "<string>",
        "Postcode": "<string>",
        "DateEstablished": "2023-12-25",
        "IsRegisteredHQ": true,
        "Commune": "<string>",
        "NAFCode": "<string>",
        "NAFName": "<string>",
        "EmployeeRange": "<string>",
        "Latitude": 123,
        "Longitude": 123,
        "PostcodeDetails": {
          "code_commune_INSEE": "<string>",
          "nom_commune_postal": "<string>",
          "code_postal": "<string>",
          "libelle_acheminement": "<string>",
          "ligne_5": "<string>",
          "latitude": 123,
          "longitude": 123,
          "code_commune": "<string>",
          "article": "<string>",
          "nom_commune": "<string>",
          "nom_commune_complet": "<string>",
          "code_departement": "<string>",
          "nom_departement": "<string>",
          "code_region": "<string>",
          "nom_region": "<string>"
        },
        "ParentCompanyNumber": "<string>",
        "ParentCompanyName": "<string>"
      }
    ],
    "FinancesByYear": [
      {
        "YearEnding": 123,
        "AccountsDate": "2023-12-25",
        "AccountsType": "<string>",
        "Turnover": 123,
        "EBIT": 123,
        "NetIncome": 123,
        "EmployeesHere": 123,
        "EmployeesTotal": 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

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

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

LegalForm

string | null

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.

Show child attributes

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

Show child attributes

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

Show child attributes

FinancesByYear

object[] | null

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

Show child attributes

SimilarCompanies

object[] | null

Similar companies to the current company

Show child attributes

Last modified on July 30, 2026

⌘I