{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/immo-spot-com/json-schema/immo-spot-com-etablissement-schema.json",
  "title": "Etablissement",
  "description": "Établissement du répertoire SIRENE de l'INSEE (SIRET), actif ou fermé. Rattaché à la parcelle la plus proche de la position BAN de son adresse, dans un rayon de 10 m. Les champs nominatifs des établissements non diffusibles sont masqués (null).\n",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/immo-spot-com-api-openapi.yml#/components/schemas/Etablissement",
  "type": "object",
  "properties": {
    "siret": {
      "type": "string",
      "description": "Numéro SIRET de l'établissement (14 chiffres)"
    },
    "siren": {
      "type": "string",
      "description": "Numéro SIREN de l'unité légale (9 chiffres)"
    },
    "nom": {
      "type": [
        "string",
        "null"
      ],
      "description": "Dénomination de l'unité légale, ou prénom et nom pour un entrepreneur individuel"
    },
    "enseigne": {
      "type": [
        "string",
        "null"
      ],
      "description": "Enseigne ou dénomination usuelle de l'établissement"
    },
    "siege": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Vrai si l'établissement est le siège de l'unité légale"
    },
    "etat": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "actif",
        "ferme"
      ],
      "description": "État administratif de l'établissement sur sa période en cours"
    },
    "date_creation": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Date de création de l'établissement (YYYY-MM-DD)"
    },
    "date_fermeture": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Date de fermeture (YYYY-MM-DD), null pour un établissement actif"
    },
    "activite": {
      "type": [
        "object",
        "null"
      ],
      "description": "Activité principale exercée (code APE, nomenclature NAF rév. 2)",
      "properties": {
        "code": {
          "type": "string",
          "description": "Code APE"
        },
        "libelle": {
          "type": [
            "string",
            "null"
          ],
          "description": "Libellé de l'activité"
        },
        "section": {
          "type": [
            "string",
            "null"
          ],
          "description": "Section NAF, en slug (voir le filtre `section_activite`)"
        }
      }
    },
    "effectifs": {
      "type": [
        "string",
        "null"
      ],
      "description": "Tranche d'effectif salarié, en slug (voir le filtre `effectifs`)"
    },
    "employeur": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Vrai si l'établissement emploie des salariés"
    },
    "categorie_juridique": {
      "type": [
        "object",
        "null"
      ],
      "description": "Catégorie juridique de l'unité légale (nomenclature INSEE)",
      "properties": {
        "code": {
          "type": "string",
          "description": "Code de catégorie juridique"
        },
        "libelle": {
          "type": [
            "string",
            "null"
          ],
          "description": "Libellé de la catégorie juridique"
        }
      }
    },
    "adresse": {
      "type": [
        "string",
        "null"
      ],
      "description": "Numéro et voie de l'établissement"
    },
    "code_postal": {
      "type": [
        "string",
        "null"
      ],
      "description": "Code postal"
    },
    "commune": {
      "type": [
        "string",
        "null"
      ],
      "description": "Libellé de la commune"
    },
    "commune_insee": {
      "type": [
        "string",
        "null"
      ],
      "description": "Code INSEE de la commune (à l'arrondissement pour Paris, Lyon et Marseille)"
    },
    "parcelle_insee": {
      "type": [
        "string",
        "null"
      ],
      "description": "Code INSEE de la parcelle rattachée, null si l'adresse n'a pas pu être localisée à la parcelle"
    },
    "adresse_etablissements_actifs": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Nombre d'établissements actifs au même numéro de voie. Un immeuble de bureaux comme une domiciliation en regroupent beaucoup.\n"
    },
    "domiciliation_probable": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Siège sans salarié à une adresse qui héberge une société de domiciliation active et au moins cinq sièges sans salarié : l'établissement n'occupe probablement pas de local sur place.\n"
    }
  }
}