{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/amass-tech/json-schema/amass-tech-biomed-core-record-schema.json",
  "title": "BiomedCoreRecord",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amass-tech-openapi.json#/components/schemas/BiomedCoreRecord",
  "type": "object",
  "properties": {
    "amassId": {
      "type": "string"
    },
    "pmid": {
      "type": [
        "string",
        "null"
      ],
      "description": "PubMed identifier — a unique numeric ID assigned by NLM to articles indexed in PubMed."
    },
    "pmcid": {
      "type": [
        "string",
        "null"
      ],
      "description": "PubMed Central identifier (e.g., PMC1234567) — identifies the full-text version archived in the PMC open-access repository. Not all PubMed articles have a PMCID."
    },
    "doi": {
      "type": [
        "string",
        "null"
      ],
      "description": "Digital Object Identifier — a persistent, publisher-assigned identifier that resolves via https://doi.org/{doi}."
    },
    "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."
    },
    "title": {
      "type": [
        "string",
        "null"
      ]
    },
    "abstract": {
      "type": [
        "string",
        "null"
      ]
    },
    "authors": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "journal": {
      "type": [
        "string",
        "null"
      ]
    },
    "issn": {
      "type": [
        "string",
        "null"
      ],
      "description": "The journal's linking ISSN (ISSN-L), the value `journalIssns` filters on."
    },
    "volumeIssue": {
      "type": [
        "string",
        "null"
      ],
      "description": "Combined volume and issue number (e.g., \"23(4)\" for volume 23 issue 4, or \"23\" when only volume is available)."
    },
    "language": {
      "type": [
        "string",
        "null"
      ],
      "description": "Three-letter ISO 639-2 language code of the article text (e.g., \"eng\", \"deu\", \"fra\")."
    },
    "publicationDate": {
      "type": [
        "string",
        "null"
      ],
      "description": "Publication date in ISO 8601 format (YYYY-MM-DD): the electronic publication date when the source record has one, otherwise the journal issue date."
    },
    "lastUpdateDate": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "The date Amass last wrote this record. It moves on any ingested change — the PubMed citation itself, PMC fulltext arriving, a citation count refreshing, or cross-core links updating — not only the publication's own content. May be null for records written before Amass tracked it."
    },
    "createDate": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Date this record first entered Amass — when it was ingested, not when it was published. This is the same value the change feed reports, so it is the field to compare a feed item against. May be null for records ingested before Amass tracked it."
    },
    "publicationTypes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "MeSH publication types categorize the nature of the article (e.g., Clinical Trial, Review, Meta-Analysis). See the full list: [https://www.nlm.nih.gov/mesh/pubtypes.html](https://www.nlm.nih.gov/mesh/pubtypes.html). `Conference` marks a record sourced from a conference abstract, and is deliberately not a MeSH term so the two are distinguishable."
    },
    "isRetracted": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Whether the article has been retracted, based on PubMed retraction notices."
    },
    "citationCount": {
      "type": [
        "number",
        "null"
      ]
    },
    "journalQualityJufo": {
      "type": "number",
      "minimum": 0,
      "maximum": 3,
      "description": "Publication Forum (Julkaisufoorumi - JuFo) is an openly published classification of publication channels created by the Finnish scientific community to support the quality assessment of academic research.\n  Each publication channel (academic journals, conferences and book publishers) is assigned a quality score which is evaluated on a regular basis and any changes are communicated publicly.\n  Each channel is assigned one of the following levels where meeting a higher level requires meeting the criteria for all lower levels, too:\n\n  - **No minimum**: Publication channels that have not been evaluated.\n  - **Low quality (JuFo Level 0)**: Publication channels that have been evaluated but do not meet all of the Level 1 criteria.\n  - **Peer reviewed (JuFo Level 1)**: includes peer-reviewed publication channels that are specialised in the publication of scientific research outcomes and have an editorial board of experts of the discipline. The majority of all publication channels are classified as Level 1 which is the basic level.\n  - **Domain leading (JuFo Level 2)**: The Levels 2 and 3 are awarded to a limited number of academic journals, conferences and book publishers of the highest level and impact as judged by the Expert Panels.\n  - **Highest quality (JuFo Level 3)**: The research published in Level 3 channels represents the highest level in the discipline and has extremely consistent impact (e.g., as measured through citation indicators).\n\n  Full explanation of the evaluation methodology behind JuFo:\n  [https://julkaisufoorumi.fi/en/evaluations/classification-criteria](https://julkaisufoorumi.fi/en/evaluations/classification-criteria)"
    },
    "meshTerms": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "MeSH (Medical Subject Headings) descriptor names assigned to the article by NLM indexers (e.g., \"COVID-19\", \"Humans\"). Browse the MeSH vocabulary: [https://meshb.nlm.nih.gov/](https://meshb.nlm.nih.gov/)"
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "substances": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Chemical and drug substance names mentioned in the article, sourced from the NLM chemical registry (e.g., \"Aspirin\", \"Acetaminophen\")."
    },
    "hasFulltext": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "referencesTrialCore": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Cross-core link to TrialCore: Amass IDs of TrialCore records referenced by this publication, linking literature to their associated clinical trials."
    },
    "fulltext": {
      "type": [
        "string",
        "null"
      ]
    },
    "authorsMetadata": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/AuthorMetadata"
      }
    },
    "substanceIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "NLM substance registry unique identifiers corresponding to each entry in substances."
    },
    "meshIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "MeSH unique identifiers corresponding to each entry in meshTerms (e.g., \"D000086382\"). Browse: [https://meshb.nlm.nih.gov/](https://meshb.nlm.nih.gov/)"
    },
    "references": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Intra-core link within BioMedCore: Amass IDs of other BioMedCore records (publications) referenced by this publication."
    },
    "citedBy": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Intra-core link within BioMedCore: Amass IDs of other BioMedCore records (publications) that cite this publication."
    }
  },
  "required": [
    "amassId",
    "pmcid",
    "doi",
    "url",
    "title",
    "abstract",
    "authors",
    "journal",
    "issn",
    "volumeIssue",
    "language",
    "publicationDate",
    "lastUpdateDate",
    "createDate",
    "publicationTypes",
    "isRetracted",
    "citationCount",
    "journalQualityJufo",
    "meshTerms",
    "keywords",
    "substances",
    "hasFulltext"
  ],
  "$defs": {
    "AuthorMetadata": {
      "type": "object",
      "properties": {
        "name": {
          "type": [
            "string",
            "null"
          ]
        },
        "nameRaw": {
          "type": [
            "string",
            "null"
          ]
        },
        "orcid": {
          "type": [
            "string",
            "null"
          ]
        },
        "position": {
          "type": [
            "number",
            "null"
          ]
        },
        "affiliations": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "nameRaw": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "ror": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "countryCode": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "name",
              "nameRaw",
              "ror",
              "countryCode"
            ]
          }
        }
      },
      "required": [
        "name",
        "nameRaw",
        "orcid",
        "position",
        "affiliations"
      ]
    }
  }
}