Titles

The titles array contains all title entries for the work. Each element comes from one of three CWR record types.

Fields

Field	Type	Req	Description
`value`	string	M	The title text
`type`	string	O	CWR title type code — see Title Types
`language`	string	O	ISO language code (e.g., `"JA"`, `"ZH"`, `"KO"`). Present on `NAT` titles only.

Sources

CWR Record	`type` value	Notes
`NWR` / `REV`	`"TT"`	The main registration title
`ALT`	`"ALT"`	Alternate title
`NAT`	`"NAT"`	Non-Roman alphabet title; carries `language`

Deduplication: {value, type} pairs that appear more than once are collapsed to a single entry.

Example

"titles": [
  { "value": "BOHEMIAN RHAPSODY", "type": "TT" },
  { "value": "BOHEMIAN RHAP", "type": "ALT" },
  { "value": "ボヘミアン・ラプソディ", "type": "NAT", "language": "JA" }
]

Identifiers

The identifiers array contains all identifiers assigned to the work.

Fields

Field	Type	Req	Description
`source`	string	M	Identifier namespace — see Identifier Sources
`value`	string	M	The identifier value

Sources

`source`	CWR Source	Description
`"iswc"`	`NWR.ISWC`, `XRF` (`ISW`)	International Standard Work Code (ISO 15707)
`"isrc"`	`XRF` (`ISR`)	ISRC cross-reference on the work
`"submitterWorkNumber"`	`NWR.SubmitterWorkNumber`	Submitter's internal work number
Society code (e.g. `"035"`)	`XRF` (`OrganisationCode`)	Society-assigned work identifier
Submitter code (e.g. `"EMI"`)	`XRF` (`OrganisationCode`)	Publisher/submitter-assigned work ID
`"proprietary"`	`XRF` (no org code)	Fallback when organisation code is missing

XRF mapping

CWR 2.2 XRF (Work ID Cross Reference) rows append to identifiers[]:

`OrganisationCode`	`source` in JSON	`value`
`ISW`	`iswc`	`Identifier`
`ISR`	`isrc`	`Identifier`
Society / submitter code	same as org code	`Identifier`
`000`, `099`	(skipped)	—

All Validity values (Y, N, U) are emitted. {source, value} duplicates (e.g. NWR ISWC + XRF ISW) are deduplicated.

Example

"identifiers": [
  { "source": "iswc", "value": "T-000.000.001-0" },
  { "source": "submitterWorkNumber", "value": "EMI-00042" },
  { "source": "035", "value": "3987389001" },
  { "source": "isrc", "value": "USRC17607839" },
  { "source": "EMI", "value": "EMI-00042" }
]

Messages

The messages object carries registration metadata, status flags, and ACK message content.

Fields

Field	Type	Req	Source	Description
`type`	string	O	`NWR` / `REV` / `ACK`	`"nwr"`, `"rev"`, or `"ack"` (lowercased)
`revocation`	object	O	`NWR.RevocationIndicator`	Present if the work was flagged for revocation
`revocation.indicator`	string	M	`NWR.RevocationIndicator`	Raw indicator value
`revocation.reason`	string	O	`NWR.RevocationReason`	Human-readable reason
`relinquishment`	object	O	`NWR.RelinquishmentIndicator`	Present if a relinquishment indicator appears
`relinquishment.indicator`	string	M	`NWR.RelinquishmentIndicator`	Raw indicator value
`creationDate`	string	O	`ACK.CreationDate`	Original file creation date (ACK)
`creationTime`	string	O	`ACK.CreationTime`	Original file creation time (ACK)
`originalGroupId`	string	O	`ACK.OriginalGroupId`	Original GRH group id (ACK)
`originalTransactionSequence`	string	O	`ACK.OriginalTransactionSeq`	Original transaction sequence (ACK)
`originalTransactionType`	string	O	`ACK.OriginalTransactionType`	e.g. `NWR` / `REV` (ACK)
`creationTitle`	string	O	`ACK.CreationTitle`	Title as submitted (ACK)
`submitterCreationNumber`	string	O	`ACK.SubmitterCreationNumber`	Submitter work id (ACK)
`recipientCreationNumber`	string	O	`ACK.RecipientCreationNumber`	Recipient work id (ACK)
`processingDate`	string	O	`ACK.ProcessingDate`	Date recipient processed the transaction
`transactionStatus`	string	O	`ACK.TransactionStatus`	Status code (`RA`, `AS`, `AC`, `RJ`, …)
`msgs`	array	O	`MSG` records	ACK validation messages (see below)
`schema`	string	M	(injected by schemaV1)	Schema label used for this output
`schemaDescription`	string	M	(injected by schemaV1)	Schema description
`societySpecific`	object	O	(reserved)	Reserved for society-specific extension data

`msgs[]` items

Field	Type	Source	Description
`status`	string	`MSG.MessageType`	Severity: `F`/`R`/`T`/`G`/`E`
`message`	string	`MSG.MessageText`	Message text
`originalRecordSequence`	string	`MSG.OriginalRecordSequence`	Record seq that caused the message
`recordType`	string	`MSG.MessageRecordType`	Record type that caused the message
`messageLevel`	string	`MSG.MessageLevel`	Edit level: `F`/`R`/`T`/`G`/`E`
`validationNumber`	string	`MSG.ValidationNumber`	Spec validation number

Example (NWR)

"messages": {
  "type": "nwr",
  "revocation": {
    "indicator": "Y",
    "reason": "Duplicate registration"
  }
}

Example (ACK)

"messages": {
  "type": "ack",
  "creationDate": "20260716",
  "creationTime": "113954",
  "originalGroupId": "00001",
  "originalTransactionSequence": "00000000",
  "originalTransactionType": "NWR",
  "creationTitle": "(WE ARE) THE COWBOYS",
  "submitterCreationNumber": "ALV003306733PW",
  "recipientCreationNumber": "0044170896001",
  "processingDate": "20260716",
  "transactionStatus": "AC",
  "msgs": [
    {
      "status": "F",
      "message": "WRITER CAE ENTERED NOT FOUND IN THE WRITER CAE TABLE",
      "originalRecordSequence": "00000008",
      "recordType": "OWR",
      "messageLevel": "F",
      "validationNumber": "009"
    }
  ]
}

Flags

The flags object holds boolean and indicator fields extracted from the NWR / REV record.

Fields

Field	Type	Req	Source Field	Description
`anomalous`	boolean	O	`NWR.AnomalousWorkIndicator`	`true` if the work is marked anomalous (`"Y"` → `true`)
`anomalousReason`	string	O	`NWR.AnomalousWorkReason`	Reason text for the anomalous flag
`aiUsage`	string	O	`NWR.AIIndicator`	AI content usage indicator. Values: `"M"` (music), `"T"` (text), `"B"` (both), etc.
`fraudulent`	boolean	O	(reserved)	Reserved for future use

Example

"flags": {
  "anomalous": true,
  "anomalousReason": "Non-standard work structure",
  "aiUsage": "M"
}

Titles

Fields

Sources

Example

Identifiers

Fields

Sources

XRF mapping

Example

Messages

Fields

msgs[] items

Example (NWR)

Example (ACK)

Flags

Fields

Example

`msgs[]` items