Updated JSON

example.markdown

{
  "id"                   : (integer, read only),
  "lid"                  : (string, read only),
  "custom_id"            : (string, optional),
  "state"                : (string, optional),

  "trusted_platforms"    : (array of integers, optional),
  "restricted_encrypted" : (boolean, optional),
  "trusted_only"         : (boolean, optional),

  "superseded_by"        : (integer, optional),
  "aliases"              : (array of strings, optional, read only),

  "created"              : (integer, read only),
  "updated"              : (integer, read only),

  "title"                : (string, optional),
  "term_start"           : (date string, YYYY-MM-DD, optional),
  "term_end"             : (date string, YYYY-MM-DD, optional),
  "media_rights"         : (array of integers, required),
  "license_type"         : (integer, required),
  "territories"          : (array of integers, optional),

  "works"                : (array of strings, required),
  "nonspecific_work"     : (boolean, optional, default: false),

  "licensee" : {
    "custom_id" : (string, optional),
    "name"      : (string, optional*),
    "email"     : (string, optional*),
    "contact"   : (string, optional),
    <custom>    : (string, optional),

    "restrcited" : {
      "name"      : (string, optional),
      "email"     : (string, optional),
      "contact"   : (string, optional),
      <custom>    : (string, optional)
    }
  },

  "third_party" : {
    "custom_id" : (string, optional),
    "name"      : (string, optional*),
    "email"     : (string, optional*),
    "contact"   : (string, optional),
    <custom>    : (string, optional),

    "restricted" : {
      "name"      : (string, optional),
      "email"     : (string, optional),
      "contact"   : (string, optional),
      <custom>    : (string, optional)
    }
  },

  "media" : [
    {
      "mid"       : (string, optional, read only),
      "custom_id" : (string, optional),
      "name"      : (string, required),
      "album"     : (string, opttional),
      "artist"    : (string, optional),
      "isrc"      : (string, optional),
      <custom>    : (string, optional),

      "restricted" : {
        "album"     : (string, opttional),
        "artist"    : (string, optional),
        "isrc"      : (string, optional),
        <custom>    : (string, optional)
      },
    },
    ...
  ],

  "collaborators" : {
    "master_rights_holders"  : (array of strings, optional),
    "publishers"             : (array of strings, optional),

    "partial_rights_holder"  : (boolean, optional, default: false),
    "other_consent_required" : (boolean, optional, default: false),

    "restricted" : {
      "master_rights_holders"  : (array of strings, optional),
      "publishers"             : (array of strings, optional),

      "partial_rights_holder"  : (boolean, optional, default: false),
      "other_consent_required" : (boolean, optional, default: false)
    }
  },

  documents: {
    "public_url"     : (string, readonly),
    "restricted_url" : (string, readonly)
  },

  "notes"  : (string, optional),
  <custom> : (string, optional),

  "restricted" {
    "notes"  : (string, optional),
    <custom> : (string, optional)
  }
}