api.invoket.com

{
  "properties": {
    "data": {
      "properties": {
        "company": {
          "description": "Minimal Sirene identity echo (name or natural person, active/ceased status) for cross-reading with /company/resolve; null when the SIREN is unknown to the Sirene stock, stated in coverage.identity - never an error",
          "properties": {
            "name": {
              "type": [
                "string",
                "null"
              ]
            },
            "natural_person": {
              "type": [
                "object",
                "null"
              ]
            },
            "status": {
              "type": "string"
            }
          },
          "required": [
            "name",
            "status"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "coverage": {
          "description": "Honest coverage: 'window' is the BODACC history span actually ingested (from/to) - an empty timeline is only meaningful over this window; 'identity' is present when the Sirene echo could not be served. Never a 5xx for staleness",
          "properties": {
            "identity": {
              "type": "string"
            },
            "window": {
              "properties": {
                "from": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "to": {
                  "type": "string"
                }
              },
              "required": [
                "from",
                "to"
              ],
              "type": "object"
            }
          },
          "required": [
            "window"
          ],
          "type": "object"
        },
        "events": {
          "description": "BODACC announcements, most recent first: family, original nature label (null when the gazette does not state it, never guessed), effective/judgment date when distinct from publication, publication date, gazette issue and notice number, court, original short text. Capped at the 100 most recent (truncated=true, total stays honest)",
          "items": {
            "properties": {
              "court": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "effective_on": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "family": {
                "type": "string"
              },
              "gazette_issue": {
                "type": "string"
              },
              "nature": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "notice_number": {
                "type": "integer"
              },
              "published_on": {
                "type": "string"
              },
              "text": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "court",
              "effective_on",
              "family",
              "gazette_issue",
              "nature",
              "notice_number",
              "published_on",
              "text"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "flags": {
          "description": "Factual flags derived mechanically from the complete timeline, never a score or a solvency opinion: has_open_insolvency_announcement (latest collective-proceeding announcement is not a closure), is_deregistered (a deregistration was published), latest_event (family and date of the most recent announcement)",
          "properties": {
            "has_open_insolvency_announcement": {
              "type": "boolean"
            },
            "is_deregistered": {
              "type": "boolean"
            },
            "latest_event": {
              "description": "Family and date of the most recent announcement, null when the timeline is empty over the covered window — an empty timeline is a successful, billed answer",
              "properties": {
                "date": {
                  "type": "string"
                },
                "family": {
                  "type": "string"
                }
              },
              "required": [
                "date",
                "family"
              ],
              "type": [
                "object",
                "null"
              ]
            }
          },
          "required": [
            "has_open_insolvency_announcement",
            "is_deregistered",
            "latest_event"
          ],
          "type": "object"
        },
        "siren": {
          "type": "string"
        },
        "total": {
          "type": "integer"
        },
        "truncated": {
          "type": "boolean"
        }
      },
      "required": [
        "company",
        "coverage",
        "events",
        "flags",
        "siren",
        "total",
        "truncated"
      ],
      "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"
}