California Institute of Technology · Schema

CaltechDATA Record

Schema for a published record returned by the CaltechDATA REST API at https://data.caltech.edu/api/records. DERIVED by API Evangelist from live response bodies observed 2026-08-19; Caltech publishes no schema of its own for this surface. The underlying record model is InvenioRDM's.

UniversityHigher EducationEducationPrivate Research UniversityInstitute of TechnologyUnited StatesCaliforniaResearch DataOpen DataResearch RepositoryIdentity FederationAstronomySeismologyResearch ComputingOAI-PMH

Properties

Name	Type	Description
id	string	CaltechDATA persistent identifier.
created	string
updated	string
revision_id	integer
is_published	boolean
is_draft	boolean
status	string
deletion_status	object
parent	object
versions	object
access	object
files	object
media_files	object
stats	object
custom_fields	object
pids	object
metadata	object
links	object

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/caltech/refs/heads/main/json-schema/caltech-caltechdata-record-schema.json",
  "title": "CaltechDATA Record",
  "description": "Schema for a published record returned by the CaltechDATA REST API at https://data.caltech.edu/api/records. DERIVED by API Evangelist from live response bodies observed 2026-08-19; Caltech publishes no schema of its own for this surface. The underlying record model is InvenioRDM's.",
  "x-operator": "institution",
  "x-provenance": {
    "generated": "2026-08-19",
    "method": "derived",
    "source": [
      "https://data.caltech.edu/api/records?size=1",
      "https://data.caltech.edu/api/records/je5p4-zyb48"
    ],
    "note": "Observation of a live API, not a Caltech-authored artifact. Do not credit as a published schema."
  },
  "type": "object",
  "required": ["id", "pids", "metadata", "links"],
  "properties": {
    "id": { "type": "string", "description": "CaltechDATA persistent identifier.", "examples": ["je5p4-zyb48"] },
    "created": { "type": "string", "format": "date-time" },
    "updated": { "type": "string", "format": "date-time" },
    "revision_id": { "type": "integer" },
    "is_published": { "type": "boolean" },
    "is_draft": { "type": "boolean" },
    "status": { "type": "string" },
    "deletion_status": { "type": "object" },
    "parent": { "type": "object" },
    "versions": { "type": "object" },
    "access": { "type": "object" },
    "files": { "type": "object" },
    "media_files": { "type": "object" },
    "stats": { "type": "object" },
    "custom_fields": { "type": "object" },
    "pids": { "$ref": "#/$defs/persistentIdentifiers" },
    "metadata": { "$ref": "#/$defs/metadata" },
    "links": { "type": "object", "additionalProperties": { "type": "string" } }
  },
  "$defs": {
    "persistentIdentifiers": {
      "type": "object",
      "description": "DOI and OAI identifiers. DOIs are minted through DataCite under Caltech's own prefix 10.22002.",
      "properties": {
        "doi": {
          "type": "object",
          "properties": {
            "identifier": { "type": "string", "examples": ["10.22002/je5p4-zyb48"] },
            "provider": { "type": "string", "examples": ["datacite"] },
            "client": { "type": "string", "examples": ["datacite"] }
          }
        },
        "oai": {
          "type": "object",
          "properties": {
            "identifier": { "type": "string", "examples": ["oai:data.caltech.edu:je5p4-zyb48"] },
            "provider": { "type": "string", "examples": ["oai"] }
          }
        }
      }
    },
    "metadata": {
      "type": "object",
      "properties": {
        "title": { "type": "string" },
        "publication_date": { "type": "string" },
        "description": { "type": "string" },
        "resource_type": { "type": "object" },
        "rights": { "type": "array", "items": { "type": "object" } },
        "creators": { "type": "array", "items": { "$ref": "#/$defs/creator" } },
        "contributors": { "type": "array", "items": { "$ref": "#/$defs/creator" } }
      }
    },
    "creator": {
      "type": "object",
      "properties": {
        "person_or_org": {
          "type": "object",
          "properties": {
            "type": { "type": "string", "enum": ["personal", "organizational"] },
            "name": { "type": "string" },
            "given_name": { "type": "string" },
            "family_name": { "type": "string" },
            "identifiers": {
              "type": "array",
              "description": "Typed person identifiers. ORCID iDs appear with scheme 'orcid'.",
              "items": {
                "type": "object",
                "properties": {
                  "identifier": { "type": "string", "examples": ["0000-0002-5590-9620"] },
                  "scheme": { "type": "string", "examples": ["orcid"] }
                }
              }
            }
          }
        },
        "affiliations": { "type": "array", "items": { "type": "object" } }
      }
    }
  }
}