CompanySearchResult

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/insourcia-io/json-schema/insourcia-io-company-search-result-schema.json",
  "title": "CompanySearchResult",
  "description": "Résultat de recherche (données légères, sans les comptes)",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/insourcia-io-openapi.yaml#/components/schemas/CompanySearchResult",
  "type": "object",
  "properties": {
    "siren": {
      "type": "string"
    },
    "denomination": {
      "type": "string"
    },
    "code_ape": {
      "type": "string"
    },
    "code_ape_lib": {
      "type": "string"
    },
    "ville": {
      "type": "string"
    },
    "departement": {
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "effectif": {
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "description": "Nombre de salariés (exact ou tranche)"
    },
    "statut": {
      "type": "string",
      "enum": [
        "ACTIVE",
        "DISSOLVED"
      ],
      "description": "Statut au registre. DISSOLVED = dissoute ou radiée ; une société en procédure collective reste ACTIVE jusqu'à sa radiation."
    },
    "date_creation": {
      "type": "string",
      "description": "Date de création de la société"
    },
    "forme_juridique": {
      "type": "string",
      "description": "Libellé de la forme juridique (nomenclature INSEE des catégories juridiques)"
    },
    "estimation_disponible": {
      "type": "boolean",
      "description": "Présent (true) quand une estimation existe. Aucun chiffre estimé n'est servi en recherche : la fourchette se lit sur `/companies/{siren}/financials`."
    },
    "estimation_ca": {
      "type": "object",
      "deprecated": true,
      "description": "Obsolète, plus servi en recherche depuis le 27/10/2026 : la fourchette est réservée à la fiche. Champ conservé dans le schéma pour les clients existants. ESTIMATION du CA, pour une société sans CA publié pour cet exercice ni un exercice\npostérieur. Absent sinon. Fourchette et confiance seulement, jamais la valeur\ncentrale ; ce n'est jamais un chiffre déposé. Détail (rentabilité) :\n`estimation_financiere` de `/companies/{siren}`.\n",
      "required": [
        "nature",
        "min",
        "max",
        "confiance"
      ],
      "properties": {
        "nature": {
          "type": "string",
          "enum": [
            "estimation"
          ]
        },
        "exercice": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Exercice estimé (année de clôture)"
        },
        "min": {
          "type": "number",
          "description": "Borne basse du CA estimé, en euros, arrondie au millier"
        },
        "max": {
          "type": "number",
          "description": "Borne haute du CA estimé, en euros, arrondie au millier"
        },
        "confiance": {
          "type": "string",
          "enum": [
            "haute",
            "moyenne",
            "faible"
          ]
        }
      }
    }
  }
}