{"openapi":"3.1.0","components":{"schemas":{"Term":{"type":"object","properties":{"scheme":{"type":"string"},"code":{"type":["string","integer","null"]},"id":{"type":"string","format":"uri-reference"},"label":{"type":"string"},"language":{"type":"string"},"labels":{"type":"object","properties":{"de":{"type":"string"},"en":{"type":"string"}}},"source_label":{"type":"string"},"translation_status":{"enum":["available","pending"]}},"required":["scheme"]},"EntityReference":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"label":{"type":"string"},"url":{"type":"string","format":"uri-reference"},"record_status":{"enum":["master","reference_only","editorial","snapshot_reference","historical_notice"]}},"required":["id","type","label"]},"Identifier":{"type":"object","properties":{"scheme":{"type":"string"},"value":{"type":"string"},"label":{"type":"string"},"uri":{"type":"string","format":"uri-reference"},"evidence":{"type":"array","items":{"type":"string","format":"uri-reference"}}},"required":["scheme","value","evidence"]},"Statement":{"type":"object","properties":{"category":{"type":"string"},"type":{"type":"string"},"value":{},"controlled_term":{"$ref":"#/components/schemas/Term"},"source_role":{"type":"string"},"evidence":{"type":"array","items":{"type":"string","format":"uri-reference"}}},"required":["evidence"]},"Relationship":{"type":"object","properties":{"type":{"type":"string"},"subject":{"$ref":"#/components/schemas/EntityReference"},"object":{"$ref":"#/components/schemas/EntityReference"},"direction":{"type":"string"},"controlled_term":{"$ref":"#/components/schemas/Term"},"source_term":{"type":"object"},"role":{"type":"string"},"role_term":{"$ref":"#/components/schemas/Term"},"term_status":{"enum":["unmapped","unspecified"]},"evidence":{"type":"array","items":{"type":"string","format":"uri-reference"}}},"required":["type","subject","object","direction","evidence"]},"Record":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"label":{"type":"string"},"record_status":{"enum":["master","reference_only","snapshot_reference","historical_notice"]},"dataset_version":{"type":"string","description":"Version of the source component that supplies the record."},"url":{"type":"string","format":"uri-reference"},"links":{"type":"object","additionalProperties":{"type":"string","format":"uri-reference"},"properties":{"citation":{"type":"string","format":"uri-reference","description":"Edition-specific record URL for citation, with HTML, JSON and JSON-LD representations."}}},"identifiers":{"type":"array","items":{"$ref":"#/components/schemas/Identifier"}},"external_concordance":{"type":"object"},"names":{"type":"array","items":{"$ref":"#/components/schemas/Statement"}},"dates":{"type":"array","items":{"$ref":"#/components/schemas/Statement"}},"classifications":{"type":"array","items":{"$ref":"#/components/schemas/Statement"}},"places":{"type":"array","items":{"$ref":"#/components/schemas/Statement"}},"facts":{"type":"array","items":{"$ref":"#/components/schemas/Statement"}},"relationships_count":{"type":"integer","minimum":0},"statements_count":{"type":"integer","minimum":0},"evidence_count":{"type":"integer","minimum":0},"identifiers_count":{"type":"integer","minimum":0},"place_snapshot_version":{"type":"string"},"catalogue_edition":{"type":"string","pattern":"^ed-[a-f0-9]{20}$","description":"Data edition to cite. Its coverage includes the catalogue, place snapshot and vocabulary."},"catalogue_history":{"type":"object","description":"Editorial notice preserving the original ID after withdrawal or merger.","required":["status","reason","previous"],"properties":{"status":{"enum":["withdrawn","merged"]},"reason":{"type":"object","required":["de","en"],"properties":{"en":{"type":"string"},"de":{"type":"string"}}},"previous":{"type":"string","format":"uri-reference"},"replacement":{"type":"string","format":"uri-reference"}}}},"required":["id","type","label","record_status","dataset_version","links","catalogue_edition"]},"EvidenceItem":{"type":"object","properties":{"id":{"type":"string"},"href":{"type":"string","format":"uri-reference"},"collection":{"type":"string"},"source_row":{"type":"integer","minimum":0}},"required":["id","href"]},"Evidence":{"type":"object","properties":{"id":{"type":"string"},"source_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"SHA-256 of the retained source file."},"source_row_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"SHA-256 of the source row in the archived data."},"source_row":{"type":"integer","minimum":0,"description":"Zero-based row number in the preserved source file. The first row is numbered 0."},"collection":{"type":"string"},"dataset_version":{"type":"string"},"citation":{"type":"string"},"row_numbering":{"const":"zero_based"}},"required":["id","collection","dataset_version"]},"Concept":{"type":"object","properties":{"id":{"type":"string","format":"uri-reference"},"scheme":{"type":"string"},"code":{"type":["string","integer","null"]},"labels":{"type":"object","properties":{"de":{"type":"string"},"en":{"type":"string"}}},"aliases":{"type":"object"},"translation_status":{"type":"string"}},"required":["id","scheme","labels"]},"Release":{"type":"object","properties":{"system":{"type":"string"},"release":{"type":"string"},"counts":{"type":"object"},"source_snapshot":{"type":"string"},"downloads":{"type":"string","format":"uri-reference"},"concordance":{"type":"string","format":"uri-reference"},"edition":{"$ref":"#/components/schemas/Edition"},"editions":{"type":"string","format":"uri-reference"},"distributions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"bytes":{"type":"integer","minimum":0},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"url":{"type":"string","format":"uri-reference"}},"required":["name","bytes","sha256","url"]}}},"required":["release","counts","downloads","edition","distributions"]},"Results":{"type":"object","properties":{"dataset_version":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/EntityReference"}},"next":{"type":"string","format":"uri-reference"}},"required":["dataset_version","items"]},"Relationships":{"type":"object","properties":{"dataset_version":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Relationship"}},"next":{"type":"string","format":"uri-reference"}},"required":["dataset_version","items"]},"Identifiers":{"type":"object","properties":{"dataset_version":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Identifier"}},"next":{"type":"string","format":"uri-reference"}},"required":["dataset_version","items"]},"Statements":{"type":"object","properties":{"dataset_version":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Statement"}},"next":{"type":"string","format":"uri-reference"}},"required":["dataset_version","items"]},"Sources":{"type":"object","properties":{"dataset_version":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/EvidenceItem"}},"next":{"type":"string","format":"uri-reference"}},"required":["dataset_version","items"]},"Vocabulary":{"type":"object","properties":{"dataset_version":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Concept"}},"next":{"type":"string","format":"uri-reference"}},"required":["dataset_version","items"]},"LinkedData":{"type":"object","properties":{"@context":{},"@id":{"type":"string","format":"uri-reference"}},"required":["@context","@id"]},"Concordance":{"type":"object","properties":{"version":{"type":"string"},"sources":{"type":"object"},"linked_original_ids":{"type":"integer","minimum":0},"downloads":{"type":"string","format":"uri-reference"}},"required":["version","sources"]},"PlaceSnapshot":{"type":"object","description":"Independent release of the July 2026 Leipzig place responses.","properties":{"version":{"type":"string"},"places":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"url":{"type":"string","format":"uri-reference"}},"required":["id","label","url"]}},"downloads":{"type":"string","format":"uri-reference"}},"required":["version","places","downloads"]},"PlaceResponse":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"version":{"type":"string"},"role_groups":{"type":"array","items":{"type":"object","properties":{"source_code":{"type":"string"},"count":{"type":"integer"},"members_url":{"type":"string","format":"uri-reference"}},"required":["source_code","count","members_url"]}},"hierarchies":{"type":"array","items":{"type":"object"}},"identifiers":{"type":"array","items":{"type":"object"}}},"required":["id","label","version","role_groups","hierarchies","identifiers"]},"PlaceMember":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"catalogue_status":{"type":"string"}},"required":["id","label","catalogue_status"]},"PlaceMembers":{"type":"object","properties":{"version":{"type":"string"},"place":{"type":"string"},"group":{"type":"object"},"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/PlaceMember"}}},"required":["version","place","group","total","items"]},"PlaceAttestations":{"type":"object","properties":{"version":{"type":"string"},"id":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"place_id":{"type":"string"},"place_label":{"type":"string"},"place_url":{"type":"string","format":"uri-reference"},"role":{"type":"object"},"member":{"$ref":"#/components/schemas/PlaceMember"}},"required":["place_id","place_label","place_url","role","member"]}}},"required":["version","id","items"]},"Edition":{"type":"object","properties":{"id":{"type":"string","pattern":"^ed-[a-f0-9]{20}$","description":"Content-derived edition fingerprint. Previously issued URLs containing this identifier still resolve."},"number":{"type":["integer","null"],"minimum":1,"description":"Permanently assigned public edition number, used in citation paths such as /version/1/id/a0003. Unregistered standalone data may omit the number."},"issued":{"type":["string","null"],"format":"date"},"catalogue":{"type":"string"},"place_snapshot":{"type":"string"},"checksums":{"type":"object","additionalProperties":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"url":{"type":"string","format":"uri-reference"},"html":{"type":"string","format":"uri-reference"},"note":{"anyOf":[{"$ref":"#/components/schemas/PublicationNote"},{"type":"object","maxProperties":0}],"description":"Brief account of the data changes in German and English. An unregistered local preview has an empty note."},"package_revisions":{"type":"array","items":{"$ref":"#/components/schemas/PackageRevision"}},"original_ids":{"type":["integer","null"],"minimum":0,"description":"Distinct original identifiers retained by the catalogue and July place source."},"semantic_id":{"type":["string","null"],"pattern":"^sc1-[a-f0-9]{64}$","description":"SHA-256 of normalized scholarly content, independent of physical file packaging."},"deposit":{"$ref":"#/components/schemas/ZenodoEditionDeposit"}},"required":["id","catalogue","place_snapshot","checksums","url","html","note","package_revisions","original_ids","semantic_id"]},"Editions":{"type":"object","properties":{"current":{"type":"string","pattern":"^ed-[a-f0-9]{20}$"},"editions":{"type":"array","items":{"$ref":"#/components/schemas/Edition"}},"component_aliases":{"type":"object","additionalProperties":{"type":"string","pattern":"^ed-[a-f0-9]{20}$"}},"publication_model":{"type":"string","enum":["explicit","standalone"],"description":"An explicit publication register or a locally inspected unregistered release."},"reviews":{"type":"array","items":{"$ref":"#/components/schemas/EditionReview"}}},"required":["current","editions","component_aliases","publication_model","reviews"]},"PublicationNote":{"type":"object","properties":{"de":{"type":"string","minLength":1},"en":{"type":"string","minLength":1}},"required":["de","en"]},"PackageRevision":{"type":"object","description":"An additional distribution of this edition with the same scholarly content.","properties":{"id":{"type":"string","pattern":"^ed-[0-9a-f]{20}$"},"issued":{"type":"string","format":"date"},"note":{"$ref":"#/components/schemas/PublicationNote"},"catalogue":{"type":"string"},"place_snapshot":{"type":"string"},"manifest":{"type":"string","format":"uri-reference"},"place_manifest":{"type":"string","format":"uri-reference"}},"required":["id","issued","note","manifest","place_manifest"]},"EditionReview":{"type":"object","description":"Completed review of the selected edition on a date when its data were unchanged.","properties":{"date":{"type":"string","format":"date"},"edition":{"type":"string","pattern":"^ed-[0-9a-f]{20}$"},"result":{"const":"unchanged"},"note":{"$ref":"#/components/schemas/PublicationNote"}},"required":["date","edition","result","note"]},"ZenodoVersionFile":{"type":"object","properties":{"name":{"type":"string","enum":["index.json","records.zip"]},"url":{"type":"string","format":"uri"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"bytes":{"type":"integer","minimum":1},"file_id":{"type":"string"}},"required":["name","url","sha256","bytes"]},"ZenodoEditionDeposit":{"type":"object","description":"Verified, permanently bound published version on Zenodo. The version DOI identifies the complete edition.","properties":{"version_doi":{"type":"string","pattern":"^10\\.5281/zenodo\\.[1-9][0-9]*$"},"record_id":{"type":"string","pattern":"^[1-9][0-9]*$"},"record_url":{"type":"string","format":"uri"},"files":{"type":"object","properties":{"index":{"$ref":"#/components/schemas/ZenodoVersionFile"},"archive":{"$ref":"#/components/schemas/ZenodoVersionFile"}},"required":["index","archive"]}},"required":["version_doi","record_id","record_url","files"]}}},"info":{"title":"openMusiXplora","version":"1.3.0","description":"Unprefixed requests read the current catalogue. For a citable view, use the /version/{edition} server with a registered number from GET /api/v1/editions. Edition-specific entity responses link to the same edition of their evidence and collections."},"servers":[{"url":"https://musixplora.modavis.org"},{"url":"https://musixplora.modavis.org/version/{edition}","variables":{"edition":{"default":"1","description":"Registered data edition number or content fingerprint"}}}],"paths":{"/api/v1/entities":{"get":{"summary":"Search or browse all original identifiers","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"field","in":"query","required":false,"schema":{"type":"string"}},{"name":"exact","in":"query","required":false,"schema":{"type":"string"}},{"name":"concept","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"supplement","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"release","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Catalogue response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Results"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"}}}},"/api/v1/entities/{id}":{"get":{"summary":"Catalogue record","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"release","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Catalogue response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Record"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"},"302":{"description":"The default was rolled back and this original ID first appeared in a later edition.","headers":{"Location":{"schema":{"type":"string","format":"uri-reference"}}}}}}},"/api/v1/entities/{id}.jsonld":{"get":{"summary":"Linked-data representation","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Catalogue response","content":{"application/ld+json":{"schema":{"$ref":"#/components/schemas/LinkedData"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"},"302":{"description":"The default was rolled back and this original ID first appeared in a later edition.","headers":{"Location":{"schema":{"type":"string","format":"uri-reference"}}}}}}},"/api/v1/release":{"get":{"summary":"Selected catalogue edition, components and checksummed distributions","parameters":[],"responses":{"200":{"description":"Catalogue response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Release"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"}}}},"/api/v1/editions":{"get":{"summary":"Published data editions, change notes, package revisions, quarterly reviews and legacy selectors","parameters":[],"responses":{"200":{"description":"Catalogue response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Editions"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"}}}},"/api/v1/evidence/{id}":{"get":{"summary":"Source row reference","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Catalogue response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evidence"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"}}}},"/api/v1/vocab":{"get":{"summary":"Controlled vocabulary","parameters":[],"responses":{"200":{"description":"Catalogue response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Vocabulary"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"}}}},"/api/v1/vocab/{scheme}/{key}":{"get":{"summary":"Bilingual concept","parameters":[{"name":"scheme","in":"path","required":true,"schema":{"type":"string"}},{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Catalogue response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Concept"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"}}}},"/version/{edition}/packages/{package}/downloads/{name}":{"get":{"summary":"Download a registered package revision for a numbered edition","parameters":[{"name":"edition","in":"path","required":true,"schema":{"type":"string"}},{"name":"package","in":"path","required":true,"schema":{"type":"string"}},{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Complete verified distribution file or its manifest"},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"},"206":{"description":"Requested byte range of the distribution file"},"416":{"description":"Unsatisfiable byte range"}},"description":"Use the manifest or place_manifest link from edition.package_revisions. A file listed by that manifest is available alongside it."},"servers":[{"url":"https://musixplora.modavis.org"}]},"/api/v1/entities/{id}/relationships":{"get":{"summary":"Relationships","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"release","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Catalogue response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Relationships"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"},"302":{"description":"The default was rolled back and this original ID first appeared in a later edition.","headers":{"Location":{"schema":{"type":"string","format":"uri-reference"}}}}}}},"/api/v1/entities/{id}/identifiers":{"get":{"summary":"Identifiers","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"release","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Catalogue response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Identifiers"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"},"302":{"description":"The default was rolled back and this original ID first appeared in a later edition.","headers":{"Location":{"schema":{"type":"string","format":"uri-reference"}}}}}}},"/api/v1/entities/{id}/statements":{"get":{"summary":"Statements","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"release","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Catalogue response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Statements"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"},"302":{"description":"The default was rolled back and this original ID first appeared in a later edition.","headers":{"Location":{"schema":{"type":"string","format":"uri-reference"}}}}}}},"/api/v1/entities/{id}/evidence":{"get":{"summary":"Evidence","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"release","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Catalogue response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sources"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"},"302":{"description":"The default was rolled back and this original ID first appeared in a later edition.","headers":{"Location":{"schema":{"type":"string","format":"uri-reference"}}}}}}},"/api/v1/concordance":{"get":{"summary":"Sources and version of the external concordance","parameters":[],"responses":{"200":{"description":"Catalogue response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Concordance"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"}}}},"/api/v1/place-snapshot":{"get":{"summary":"July 2026 Leipzig place retrieval and its provenance","parameters":[{"name":"version","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Catalogue response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceSnapshot"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"}}}},"/api/v1/place-snapshot/places/{id}":{"get":{"summary":"Place description, hierarchies and membership groups","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Catalogue response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceResponse"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"}}}},"/api/v1/place-snapshot/places/{id}/members":{"get":{"summary":"Recorded members of one place role group","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"group","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"version","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Catalogue response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceMembers"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"}}}},"/api/v1/place-snapshot/entities/{id}":{"get":{"summary":"Place attestations for an original member ID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Catalogue response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceAttestations"}}}},"400":{"description":"Invalid parameters"},"404":{"description":"Unknown resource or release"}}}}}}