Skip to content
firmus.shdocs

Every page's text, headings and title. Code samples are not indexed.

firmus.sh

Get

Read one establishment by its establishment number.

One place a company operates from: its own identifier, address, activity and opening dates, plus the identity of the legal entity it belongs to. Its country_data carries the source fields with no canonical column, under their original names — the one thing a list item never has. data_updated_at is the register's own timestamp for the record, not the time it was imported.

The key travels as an Authorization header here; the query form works on /suggest alone, and authentication says why.

GET/v1/{country_code}/establishments/{establishment_number}Scope read

Parameters

ParameterInTypeRequiredExample
country_codepathstringYesfr
establishment_numberpathstringYes55203253400041

Request

bash
curl -H "Authorization: Bearer $FIRMUS_KEY" \
  "https://api.firmus.sh/v1/fr/establishments/55203253400041"

Fields

  • country_codestring
  • establishment_numberstring
  • legal_entityobjectnullable
    • country_codestring
    • registry_numberstring
    • namestringnullable
  • head_officeboolean
  • namestringnullable
  • activityobject
    • codestringnullable
    • schemestringnullable
  • workforceobject
    • range_codestringnullable
    • schemestringnullable
    • yearintegernullable
  • statusstring
  • opened_onstringnullable
  • closed_onstringnullable
  • addressobject
    • streetstringnullable
    • complementstringnullable
    • postal_codestringnullable
    • citystringnullable
    • latitudenumber (float)nullable
    • longitudenumber (float)nullable
  • partially_disclosedboolean
  • data_updated_atstringnullable
  • country_dataobjectnullable
    • code_communestringnullable
    • enseigne2stringnullable
    • enseigne3stringnullable
    • caractere_employeurbooleannullable
    • activite_registre_metiersstringnullable
    • identifiant_adressestringnullable
    • distribution_specialestringnullable
    • code_cedexstringnullable
    • libelle_cedexstringnullable
    • code_pays_etrangerstringnullable
    • libelle_pays_etrangerstringnullable
    • coordonnee_lambert_abscissenumber (float)nullable
    • coordonnee_lambert_ordonneenumber (float)nullable
    • …and any other field the source publishes for this record.

Responses

The canonical card of one establishment, the identity of the legal entity it belongs to, and country_data: the source fields that have no canonical column, under their original names.

{
  "country_code": "fr",
  "establishment_number": "55203253400041",
  "legal_entity": null,
  "head_office": true,
  "name": "SIEGE DANONE",
  "activity": {
    "code": "70.10Z",
    "scheme": "naf2008"
  },
  "workforce": {
    "range_code": "42",
    "scheme": "insee_tranche_effectifs",
    "year": 2023
  },
  "status": "active",
  "opened_on": "1955-12-31",
  "closed_on": null,
  "address": {
    "street": "17 BD HAUSSMANN",
    "complement": "BATIMENT A",
    "postal_code": "75009",
    "city": "PARIS 9",
    "latitude": 48.873792,
    "longitude": 2.334132
  },
  "partially_disclosed": false,
  "data_updated_at": "2026-07-15T07:12:33Z",
  "country_data": null
}

Try it

Calls the real API with a demo key. No account, no signup.