Titles, Identifiers, Messages, Flags

Titles

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

Fields

FieldTypeReqDescription
valuestringMThe title text
typestringOCWR title type code — see Title Types
languagestringOISO language code (e.g., "JA", "ZH", "KO"). Present on NAT titles only.

Sources

CWR Recordtype valueNotes
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

FieldTypeReqDescription
sourcestringMIdentifier namespace — see Identifier Sources
valuestringMThe identifier value

Sources

sourceCWR Source FieldDescription
"iswc"NWR.ISWCInternational Standard Work Code (ISO 15707)
"submitterWorkNumber"NWR.SubmitterWorkNumberSubmitter's internal work number
"proprietary"(varies)Other proprietary identifier

Example

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

Messages

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

Fields

FieldTypeReqSourceDescription
typestringONWR / REV record type"nwr" or "rev" (lowercased)
revocationobjectONWR.RevocationIndicatorPresent if the work was flagged for revocation
revocation.indicatorstringMNWR.RevocationIndicatorRaw indicator value
revocation.reasonstringONWR.RevocationReasonHuman-readable reason
relinquishmentobjectONWR.RelinquishmentIndicatorPresent if a relinquishment indicator appears
relinquishment.indicatorstringMNWR.RelinquishmentIndicatorRaw indicator value
msgsarrayOMSG recordsACK file messages — each: { status, message }
schemastringM(injected by schemaV1)Schema label used for this output
schemaDescriptionstringM(injected by schemaV1)Schema description
societySpecificobjectO(reserved)Reserved for society-specific extension data

Example

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

Flags

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

Fields

FieldTypeReqSource FieldDescription
anomalousbooleanONWR.AnomalousWorkIndicatortrue if the work is marked anomalous ("Y"true)
anomalousReasonstringONWR.AnomalousWorkReasonReason text for the anomalous flag
aiUsagestringONWR.AIIndicatorAI content usage indicator. Values: "M" (music), "T" (text), "B" (both), etc.
fraudulentbooleanO(reserved)Reserved for future use

Example

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