Skip to content
firmus.shdocs

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

firmus.sh

Get

Read one legal entity by its registry number.

registered_address is the head office's, so a company that has moved keeps its registry number and answers here with the new one. For the places it operates from, read its establishments. 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}/legal-entities/{registry_number}Scope read

Parameters

ParameterInTypeRequiredExample
country_codepathstringYesfr
registry_numberpathstringYes552032534

Request

bash
curl -H "Authorization: Bearer $FIRMUS_KEY" \
  "https://api.firmus.sh/v1/fr/legal-entities/552032534"

Fields

  • country_codestring
  • registry_numberstring
  • kindstring
  • namestringnullable
  • legal_formobject
    • codestringnullable
    • schemestringnullable
  • activityobject
    • codestringnullable
    • schemestringnullable
  • workforceobject
    • range_codestringnullable
    • schemestringnullable
    • yearintegernullable
  • size_categoryobject
    • codestringnullable
    • schemestringnullable
    • yearintegernullable
  • statusstring
  • registered_onstringnullable
  • ceased_onstringnullable
  • registered_addressobject
    • linestringnullable
    • postal_codestringnullable
    • citystringnullable
  • partially_disclosedboolean
  • data_updated_atstringnullable
  • country_dataobjectnullable
    • siglestringnullable
    • denomination_usuelle1stringnullable
    • denomination_usuelle2stringnullable
    • denomination_usuelle3stringnullable
    • economie_sociale_solidairebooleannullable
    • societe_missionbooleannullable
    • caractere_employeurbooleannullable
    • identifiant_associationstringnullable
    • activite_principale_naf25stringnullable
    • unite_purgeebooleannullable
    • …and any other field the source publishes for this record.

Responses

The canonical card of one legal entity, followed by country_data: the source fields that have no canonical column, under their original names. null when the country publishes no extension for this entity.

{
  "country_code": "fr",
  "registry_number": "552032534",
  "kind": "company",
  "name": "DANONE",
  "legal_form": {
    "code": "5710",
    "scheme": "insee_cj_2018"
  },
  "activity": {
    "code": "70.10Z",
    "scheme": "naf2008"
  },
  "workforce": {
    "range_code": "52",
    "scheme": "insee_tranche_effectifs",
    "year": 2023
  },
  "size_category": {
    "code": "GE",
    "scheme": "insee_categorie_entreprise",
    "year": 2023
  },
  "status": "active",
  "registered_on": "1955-12-31",
  "ceased_on": null,
  "registered_address": {
    "line": "17 BD HAUSSMANN",
    "postal_code": "75009",
    "city": "PARIS 9"
  },
  "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.