api.invoket.com

{
  "properties": {
    "data": {
      "properties": {
        "article": {
          "type": "string"
        },
        "celex": {
          "type": "string"
        },
        "changed": {
          "description": "Whether the consolidated text differs between the two dates (false when the same version is in force at both). When false the diff is returned empty — no segments, empty unified patch, zero counters: the article's text itself is sold by /legal/article?date=",
          "type": "boolean"
        },
        "code": {
          "type": "string"
        },
        "coverage_window": {
          "description": "Period over which this text or act is actually queryable: from (inclusive) and to (exclusive, null when open) — how far back a monitoring agent can diff without paying for a call that will fail",
          "type": "object"
        },
        "diff": {
          "properties": {
            "added": {
              "type": "integer"
            },
            "changed": {
              "type": "boolean"
            },
            "removed": {
              "type": "integer"
            },
            "segments": {
              "items": {
                "properties": {
                  "op": {
                    "description": "Word-level diff operation for this segment: 'equal', 'insert' (present only at 'to') or 'delete' (present only at 'from')",
                    "type": "string"
                  },
                  "text": {
                    "type": "string"
                  }
                },
                "required": [
                  "op",
                  "text"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "unified": {
              "type": "string"
            }
          },
          "required": [
            "added",
            "changed",
            "removed",
            "segments",
            "unified"
          ],
          "type": "object"
        },
        "differs": {
          "description": "changed OR status_changed OR in_force_changed — the single field to filter on to monitor a citation: it catches a rewritten text, a repeal that left the wording untouched, and a repeal that left the status untouched too",
          "type": "boolean"
        },
        "eli": {
          "type": "string"
        },
        "from": {
          "type": "string"
        },
        "from_in_force": {
          "type": "boolean"
        },
        "from_version": {
          "description": "Version in force at the 'from' date, or null if none (e.g. before the first version) — the diff then shows a full insertion. 'date_fin' closes the version (absent while it is still open) and 'continuity' tells whether the article number kept designating the same text across the change ('same_article') or was renumbered ('renumbered') - French law only",
          "properties": {
            "continuity": {
              "type": "string"
            },
            "date_debut": {
              "type": "string"
            },
            "date_fin": {
              "type": "string"
            },
            "etat": {
              "type": "string"
            },
            "version_id": {
              "type": "string"
            }
          },
          "required": [
            "date_debut",
            "etat",
            "version_id"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "in_force_changed": {
          "description": "Whether the text stopped (or started) being the applicable law between the two dates — the only flag that fires on a French-style repeal, where both dates resolve to the same version and both 'changed' and 'status_changed' stay false",
          "type": "boolean"
        },
        "label": {
          "type": "string"
        },
        "renumbering_suspected": {
          "description": "Whether a renumbering break falls between the two dates: the article number stopped designating one text and started designating another, so the diff describes a change that never happened. French Civil Code art. 1240 from 2000-01-01 returns a perfectly credible diff between 'payment made in good faith' (the old art. 1240) and tort liability (the old art. 1382, renumbered 1240 in 2016). The diff itself is unchanged and this flag stays out of 'differs' — it is a warning about how to read the diff, not one more change event. Always false for EU law, whose consolidations keep their numbering",
          "type": "boolean"
        },
        "status_changed": {
          "description": "Whether the legal status (etat) differs between the two dates — true on a repeal that keeps the last known wording, where 'changed' stays false, and whenever only one of the two dates has a version at all",
          "type": "boolean"
        },
        "to": {
          "type": "string"
        },
        "to_in_force": {
          "type": "boolean"
        },
        "to_version": {
          "description": "Version retained at the 'to' date, or null if none (e.g. before the first version) — the diff then shows a full deletion. 'date_fin' closes the version (absent while it is still open) and 'continuity' tells whether the article number kept designating the same text across the change ('same_article') or was renumbered ('renumbered') - French law only",
          "properties": {
            "continuity": {
              "type": "string"
            },
            "date_debut": {
              "type": "string"
            },
            "date_fin": {
              "type": "string"
            },
            "etat": {
              "type": "string"
            },
            "version_id": {
              "type": "string"
            }
          },
          "required": [
            "date_debut",
            "etat",
            "version_id"
          ],
          "type": [
            "object",
            "null"
          ]
        }
      },
      "required": [
        "changed",
        "diff",
        "differs",
        "from",
        "from_in_force",
        "from_version",
        "in_force_changed",
        "label",
        "renumbering_suspected",
        "status_changed",
        "to",
        "to_in_force",
        "to_version"
      ],
      "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"
}