api.invoket.com

{
  "properties": {
    "data": {
      "properties": {
        "acronym": {
          "type": [
            "string",
            "null"
          ]
        },
        "coverage": {
          "description": "Honest coverage: register fields that are absent (partial/protected dissemination) are listed in 'missing' as JSON paths of data, never filled in - and never a 5xx",
          "properties": {
            "establishment": {
              "type": "string"
            },
            "missing": {
              "type": "array"
            }
          },
          "required": [
            "missing"
          ],
          "type": "object"
        },
        "created_on": {
          "type": [
            "string",
            "null"
          ]
        },
        "headquarters": {
          "description": "Head-office establishment (SIRET, status, structured address, creation date); address.country is null for France. A 'siret' query for a secondary establishment resolves to its legal unit with coverage.establishment='resolved_to_legal_unit'",
          "properties": {
            "address": {
              "properties": {
                "city": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "country": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "line": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "postal_code": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "city",
                "line",
                "postal_code"
              ],
              "type": "object"
            },
            "created_on": {
              "type": [
                "string",
                "null"
              ]
            },
            "siret": {
              "type": "string"
            },
            "status": {
              "type": "string"
            }
          },
          "required": [
            "address",
            "created_on",
            "siret",
            "status"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "is_employer": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "is_headquarters": {
          "type": "boolean"
        },
        "last_processed_on": {
          "type": [
            "string",
            "null"
          ]
        },
        "legal_form": {
          "description": "INSEE legal category code with its label from the embedded official nomenclature; label is null for a code outside the nomenclature, never a guessed label",
          "properties": {
            "code": {
              "type": "string"
            },
            "label": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "code",
            "label"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "lei": {
          "description": "Global legal identity attached to this SIREN, present when a LEI record declares it — absent means no LEI declares this SIREN, never that the company has none",
          "type": "object"
        },
        "main_activity": {
          "properties": {
            "code": {
              "type": "string"
            },
            "label": {
              "type": [
                "string",
                "null"
              ]
            },
            "nomenclature": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "code",
            "label",
            "nomenclature"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "name": {
          "description": "Legal name of the company, null for a sole trader (an individual): the identity then sits in natural_person. Both cases are ordinary successful answers",
          "type": [
            "string",
            "null"
          ]
        },
        "natural_person": {
          "type": [
            "object",
            "null"
          ]
        },
        "siren": {
          "type": "string"
        },
        "social_economy": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "status": {
          "description": "Administrative status in the Sirene register: 'active' or 'ceased'. A ceased company is a successful, billed answer - the status is the information",
          "type": "string"
        },
        "workforce": {
          "description": "INSEE workforce band code with its validity year - a band, never a guessed headcount",
          "properties": {
            "bracket": {
              "type": "string"
            },
            "year": {
              "type": [
                "integer",
                "null"
              ]
            }
          },
          "required": [
            "bracket",
            "year"
          ],
          "type": [
            "object",
            "null"
          ]
        }
      },
      "required": [
        "acronym",
        "coverage",
        "created_on",
        "headquarters",
        "last_processed_on",
        "legal_form",
        "main_activity",
        "name",
        "siren",
        "social_economy",
        "status",
        "workforce"
      ],
      "type": "object"
    },
    "provenance": {
      "properties": {
        "fetched_at": {
          "type": "string"
        },
        "freshness": {
          "properties": {
            "as_of": {
              "type": "string"
            },
            "kind": {
              "type": "string"
            }
          },
          "required": [
            "as_of",
            "kind"
          ],
          "type": "object"
        },
        "source": {
          "type": "string"
        }
      },
      "required": [
        "fetched_at",
        "freshness",
        "source"
      ],
      "type": "object"
    }
  },
  "required": [
    "data",
    "provenance"
  ],
  "type": "object"
}