{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/vaquill-ai/json-schema/vaquill-ai-chronology-event-schema.json",
  "title": "ChronologyEvent",
  "description": "One dated event on the matter's timeline.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/vaquill-ai-chronology-api-openapi.yml#/components/schemas/ChronologyEvent",
  "properties": {
    "id": {
      "type": "string",
      "title": "Id",
      "description": "`evt_` identifier."
    },
    "matterId": {
      "type": "string",
      "title": "Matterid",
      "description": "The `mat_` matter this event belongs to."
    },
    "documentId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Documentid",
      "description": "The `doc_` document this event was extracted from, or null for an event somebody entered by hand."
    },
    "documentName": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Documentname",
      "description": "That document's filename, resolved at read time."
    },
    "eventDate": {
      "type": "string",
      "format": "date",
      "title": "Eventdate",
      "description": "When it happened."
    },
    "eventDateEnd": {
      "anyOf": [
        {
          "type": "string",
          "format": "date"
        },
        {
          "type": "null"
        }
      ],
      "title": "Eventdateend",
      "description": "The end of the range, for an event that spans days."
    },
    "eventDateApproximate": {
      "type": "boolean",
      "title": "Eventdateapproximate",
      "description": "True when the source dated this loosely ('early 2024')."
    },
    "eventType": {
      "type": "string",
      "title": "Eventtype",
      "description": "What happened, for example `signed`, `filed` or `hearing`. Read it as an open string: the column carries no constraint, so production can hold a value this API would refuse on a write."
    },
    "category": {
      "type": "string",
      "title": "Category",
      "description": "The swim lane it groups into. Open, as `eventType` is."
    },
    "significance": {
      "type": "string",
      "title": "Significance",
      "description": "`high`, `medium` or `low`. Open, as above."
    },
    "title": {
      "type": "string",
      "title": "Title",
      "description": "A one-line description of the event."
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Description",
      "description": "The longer account, when there is one."
    },
    "parties": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Parties",
      "description": "Who was involved."
    },
    "tags": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Tags",
      "description": "Free-form labels."
    },
    "sourceText": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sourcetext",
      "description": "The passage the event was extracted from. Locate this string in the document's text to find it; there is no offset to trust."
    },
    "sourcePageNumber": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sourcepagenumber",
      "description": "The page the passage was found on, when it could be resolved."
    },
    "isAiExtracted": {
      "type": "boolean",
      "title": "Isaiextracted",
      "description": "False for an event created through this API or typed into the product."
    },
    "confidenceScore": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Confidencescore",
      "description": "0 to 1 for an extracted event, null for a manual one."
    },
    "isPrimaryInGroup": {
      "type": "boolean",
      "title": "Isprimaryingroup",
      "description": "False when this event duplicates another and was not chosen as the representative. Pass `primaryOnly=true` to drop the non-primary copies."
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "title": "Createdat",
      "description": "When the row was written."
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "title": "Updatedat",
      "description": "When it last changed."
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "id",
    "matterId",
    "eventDate",
    "eventDateApproximate",
    "eventType",
    "category",
    "significance",
    "title",
    "isAiExtracted",
    "isPrimaryInGroup",
    "createdAt",
    "updatedAt"
  ]
}