Skip to content
firmus.shdocs

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

firmus.sh

List establishments

Every establishment of one legal entity, head office first.

page defaults to 1 and per_page to 20; both are clamped, never rejected. The values in the table below are the contract's examples, not its defaults.

Every field of one establishment is here except country_data, which is always null on a list item rather than absent. The key travels as an Authorization header; the query form works on /suggest alone.

GET/v1/{country_code}/legal-entities/{registry_number}/establishmentsScope read

Parameters

ParameterInTypeRequiredExample
country_codepathstringYesfr
registry_numberpathstringYes552032534
include_closedquerybooleanNotrue
pagequeryintegerNo2
per_pagequeryintegerNo1

Request

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

Fields

  • establishmentsobject[]
    • []objectoptional
      • 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.
  • paginationobject
    • pageinteger
    • per_pageinteger
    • total_countinteger
    • total_pagesinteger

Responses

The establishments of one legal entity, head office first, then by establishment number. Closed establishments are excluded unless include_closed is set. List items carry no country_data — read one establishment to get it.

{
  "establishments": [],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total_count": 0,
    "total_pages": 0
  }
}

Try it

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