{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/amass-tech/json-schema/amass-tech-patent-core-record-schema.json",
  "title": "PatentCoreRecord",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amass-tech-openapi.json#/components/schemas/PatentCoreRecord",
  "type": "object",
  "properties": {
    "amassId": {
      "type": "string"
    },
    "publicationNumber": {
      "type": [
        "string",
        "null"
      ],
      "description": "Publication number of the patent (e.g. US-10266485-B2). The source-neutral identity key."
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Link to the source of this record. The target may change over time; use the identifier fields to build links to specific external systems."
    },
    "applicationNumber": {
      "type": [
        "string",
        "null"
      ],
      "description": "Application number of the patent."
    },
    "countryCode": {
      "type": [
        "string",
        "null"
      ],
      "description": "Jurisdiction / patent-office code (e.g. US, EP, WO, CN)."
    },
    "kindCode": {
      "type": [
        "string",
        "null"
      ],
      "description": "Publication kind code indicating the document type/stage (e.g. A1, B2)."
    },
    "familyId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Patent family identifier grouping publications of the same invention across jurisdictions."
    },
    "familyMembers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PatentCore Amass IDs (AMPC_…) of the other members of this patent's family that were collapsed into this result (siblings across jurisdictions/stages) — dereference each via the get/batch endpoint. Empty when family collapse is off or no siblings were found."
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "Patent title (English-preferred)."
    },
    "abstract": {
      "type": [
        "string",
        "null"
      ],
      "description": "Patent abstract (English-preferred)."
    },
    "language": {
      "type": [
        "string",
        "null"
      ],
      "description": "Language of the full text."
    },
    "nonEnglishFallback": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "True when the text is the original non-English language (no English text was available)."
    },
    "cpcCodes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Cooperative Patent Classification (CPC) codes."
    },
    "ipcCodes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "International Patent Classification (IPC) codes."
    },
    "inventors": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Inventor names."
    },
    "assignees": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Assignee / applicant names."
    },
    "publicationDate": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Date the document entered the public record (~18 months after filing for applications)."
    },
    "filingDate": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Date this application was filed at this office; anchors the 20-year term."
    },
    "grantDate": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Grant/issue date; null for pending or never-granted applications, so a grant-date filter implicitly restricts to granted patents."
    },
    "priorityDate": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Earliest priority date — the invention's effective date and the correct field for prior-art and innovation-trend queries."
    },
    "citedPatents": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "BACKWARD citations (prior art this patent cites): PatentCore Amass IDs (AMPC_…) of the earlier patents THIS patent points to — dereference each via the get/batch endpoint. Returned by default. Cited patents outside our life-science corpus are dropped, so this list can be shorter than the patent's true backward-citation count."
    },
    "priorityClaimNumbers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Publication numbers claimed as priority."
    },
    "parentPublicationNumbers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Parent publication numbers in the lineage."
    },
    "childPublicationNumbers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Child publication numbers in the lineage."
    },
    "hasClaims": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Whether the patent has claims text."
    },
    "hasDescription": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Whether the patent has a description."
    },
    "nplCount": {
      "type": [
        "number",
        "null"
      ],
      "description": "BACKWARD citation count: how many non-patent-literature references (papers, books, standards) this patent cites. The full list is opt-in via ?include=nplCitations, so this count is returned by default in its place."
    },
    "citedByCount": {
      "type": [
        "number",
        "null"
      ],
      "description": "FORWARD citation count: how many LATER patents cite THIS one — a downstream-impact signal that grows over time. The list of those patents is opt-in via ?include=citedByPatents; this count stays exact even when that list is capped."
    },
    "claims": {
      "type": [
        "string",
        "null"
      ],
      "description": "Full claims text. Included with ?include=claims."
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Full description text. Included with ?include=description."
    },
    "nplCitations": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "BACKWARD citations: raw non-patent-literature reference strings (papers, books, standards) this patent cites. Count is nplCount. Included with ?include=nplCitations."
    },
    "citedByPatents": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "FORWARD citations: PatentCore Amass IDs (AMPC_…) of LATER patents that cite THIS one (who points at it) — dereference each via the get/batch endpoint. Count is citedByCount, which stays exact even though this list drops citing patents outside our life-science corpus. Included with ?include=citedByPatents."
    },
    "referencesDrugCore": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Cross-core link to DrugCore: Amass IDs of DrugCore records (drugs) disclosed in or linked to this patent, resolved from the patent's ChEMBL ids. Included with ?include=referencesDrugCore."
    },
    "referencesBiomedCore": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Cross-core link to BiomedCore: Amass IDs (AMBC_…) of BiomedCore papers this patent cites, resolved from the DOIs regex-extracted from its non-patent-literature citations. DOIs with no BiomedCore paper (outside our life-science corpus) are dropped. Included with ?include=referencesBiomedCore."
    }
  },
  "required": [
    "amassId",
    "publicationNumber",
    "url",
    "applicationNumber",
    "countryCode",
    "kindCode",
    "familyId",
    "familyMembers",
    "title",
    "abstract",
    "language",
    "nonEnglishFallback",
    "cpcCodes",
    "ipcCodes",
    "inventors",
    "assignees",
    "publicationDate",
    "filingDate",
    "grantDate",
    "priorityDate",
    "citedPatents",
    "priorityClaimNumbers",
    "parentPublicationNumbers",
    "childPublicationNumbers",
    "hasClaims",
    "hasDescription",
    "nplCount",
    "citedByCount"
  ]
}