Work Metadata

Each entry in the works array corresponds to one NWR or REV transaction in the source CWR file.

Fields

FieldTypeReqDescription
messagesobjectMRegistration metadata, ACK messages, and schema metadata (schema, schemaDescription)
flagsobjectOBoolean indicators from the registration record
titlesarrayOAll titles for the work (original, alternate, non-Roman)
identifiersarrayOAll identifiers (ISWC, submitter work number, XRF cross-refs)
partiesarrayOOwnership chain — writers and publishers with hierarchical representedBy nesting and per-territory shares (ownership and collection)
recordingsarrayOCommercial recordings (ISRC, album, label, release date)

Territorial shares

Shares are represented inside parties[].territories[]:

  • shareTypes[].type: "own" — ownership from SPU/OPU/SWR/OWR (empty TIS scope, not territory-coded)
  • shareTypes[].type: "coll" — collection percentages for that territory

See Interested Parties and Territories & Shares.


Minimal work object

{
  "messages": {
    "type": "nwr",
    "schema": "CWR-JSON Schema v1.0",
    "schemaDescription": "..."
  },
  "titles": [
    { "value": "BOHEMIAN RHAPSODY", "type": "TT" }
  ],
  "identifiers": [
    { "source": "iswc", "value": "T-000.000.001-0" },
    { "source": "submitterWorkNumber", "value": "EMI-00042" }
  ]
}

Complete work object

See Example: Simple NWR for a full work with parties and recordings.


Did this page help you?