{
  "schema_version": "qaz.bio.data-contract.v1",
  "canonical_url": "https://qaz.bio/data/data-contract.json",
  "scope": "reviewed_public_layer_only",
  "entity_id_namespace": "qbio:",
  "statement_id_namespace": "qbst:",
  "languages": ["kk", "ru", "en"],
  "formats": {
    "public_index": "https://qaz.bio/data/public-index.json",
    "entities_ndjson": "https://qaz.bio/api/v1/entities.ndjson",
    "entities_ndjson_filtered": "https://qaz.bio/api/v1/entities.ndjson?kind={person_or_organisation}&source_system={source_system}&completeness={roles_aliases_relationships_places_facts}",
    "statements_ndjson": "https://qaz.bio/api/v1/statements.ndjson",
    "statements_ndjson_filtered": "https://qaz.bio/api/v1/statements.ndjson?kind={person_or_organisation}&property={property}&source_system={source_system}",
    "facets": "https://qaz.bio/api/v1/facets",
    "change_feed": "https://qaz.bio/api/v1/changes?since={sequence}",
    "project_consumers": "https://qaz.bio/data/project-consumers.json",
    "reconciliation": "https://qaz.bio/api/v1/reconcile?q={query}&kind={person_or_organisation}&limit={limit}",
    "correction_intake": "https://qaz.bio/api/v1/corrections",
    "correction_status": "https://qaz.bio/api/v1/corrections/{receipt_id}"
  },
  "public_filters": {
    "entities_ndjson.kind": ["person", "organisation"],
    "entities_ndjson.completeness": ["roles", "aliases", "relationships", "places", "facts"],
    "entities_ndjson.source_system": "one public source_refs.system value",
    "statements_ndjson.kind": ["person", "organisation"],
    "statements_ndjson.property": ["name", "alias", "description", "role", "place", "relationship", "external_reference", "fact.<summary_key>"],
    "statements_ndjson.source_system": "only applies to external_reference statement values"
  },
  "schemas": {
    "entity": "https://qaz.bio/schemas/public-entity.schema.json",
    "statement": "https://qaz.bio/schemas/public-statement.schema.json"
  },
  "date_semantics": {
    "evidence.captured_at": "time when the source was retrieved",
    "publication.reviewed_at": "time when the reviewed profile was published or updated",
    "qualifiers.start_date": "start of the asserted role or relationship",
    "qualifiers.end_date": "end of the asserted role or relationship"
  },
  "guarantees": [
    "Candidate and review records are excluded from every public format.",
    "Every public profile has at least one evidence receipt.",
    "Every public child claim has an evidence receipt.",
    "Reconciliation results are suggestions and never merge or publish an identity.",
    "Correction requests are receipts, not public facts; they change profiles only after editorial review."
  ]
}