ISWC Database Agency REST API

API change history

ISWC Database Agency/Society REST API

Retrieve a list of CSN notifications associated with an Agency

Retrieve a list of CSN notifications associated with an Agency

Try it

Request

Request URL

Request parameters

  • string

    CISAC Agency identifier

  • string

    Type of transaction requested

  • string

    Format - YYYY-MM-DD. The date from which to retrieve notifications

  • integer

    Format - int32. Number of records to return

  • (optional)
    string

    Used to page through results

Request headers

  • string
    Subscription key which provides access to this API. Found in your Profile.

Request body

Responses

200 OK

List of notifications

Representations

{
  "notifications": [
    {
      "submittingAgencyCode": "string",
      "receivingAgencyCode": "string",
      "toIswc": "string",
      "fromIswc": "string",
      "processingDate": "string",
      "csnTransactionType": "MER",
      "workflowTaskId": "string",
      "workflowStatus": "Outstanding",
      "receivingAgencyWorkCode": "string",
      "processedOnDate": "string",
      "iswcMetadata": {
        "createdDate": "string",
        "lastModifiedDate": "string",
        "lastModifiedBy": "string",
        "iswc": "string",
        "agency": "string",
        "originalTitle": "string",
        "otherTitles": [
          {
            "title": "string",
            "type": "CT"
          }
        ],
        "interestedParties": [
          {
            "name": "string",
            "lastName": "string",
            "nameNumber": 0,
            "baseNumber": "string",
            "affiliation": "string",
            "role": "CA",
            "legalEntityType": "N"
          }
        ],
        "works": [
          {
            "id": 0,
            "iswc": "string",
            "iswcEligible": true,
            "deleted": true,
            "linkedFrom": "string",
            "linkedTo": "string",
            "rejection": {
              "code": "string",
              "message": "string"
            },
            "archivedIswc": "string",
            "overallParentISWC": "string",
            "agency": "string",
            "sourcedb": 0,
            "workcode": "string",
            "category": "DOM",
            "disambiguation": true,
            "disambiguationReason": "DIT",
            "disambiguateFrom": [
              {
                "iswc": "string"
              }
            ],
            "bvltr": "Background",
            "derivedWorkType": "ModifiedVersion",
            "derivedFromIswcs": [
              {
                "iswc": "string",
                "title": "string"
              }
            ],
            "performers": [
              {
                "firstName": "string",
                "lastName": "string"
              }
            ],
            "instrumentation": [
              {
                "code": "string"
              }
            ],
            "cisnetCreatedDate": "string",
            "cisnetLastModifiedDate": "string",
            "additionalIdentifiers": {
              "isrcs": [
                "string"
              ],
              "publisherIdentifiers": [
                {
                  "nameNumber": 0,
                  "submitterCode": "string",
                  "workCode": [
                    "string"
                  ]
                }
              ],
              "agencyWorkCodes": [
                {
                  "agency": "string",
                  "workCode": "string"
                }
              ]
            },
            "originalTitle": "string",
            "otherTitles": [
              {
                "title": "string",
                "type": "CT"
              }
            ],
            "interestedParties": [
              {
                "name": "string",
                "lastName": "string",
                "nameNumber": 0,
                "baseNumber": "string",
                "affiliation": "string",
                "role": "CA",
                "legalEntityType": "N"
              }
            ],
            "createdDate": "string",
            "lastModifiedDate": "string",
            "lastModifiedBy": "string"
          }
        ],
        "parentISWC": "string",
        "linkedISWC": [
          "string"
        ],
        "overallParentISWC": "string"
      },
      "workflowMessage": "string"
    }
  ],
  "continuationToken": "string"
}
{
  "type": "object",
  "properties": {
    "notifications": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "submittingAgencyCode": {
            "maxLength": 3,
            "minLength": 3,
            "type": "string"
          },
          "receivingAgencyCode": {
            "maxLength": 3,
            "minLength": 3,
            "type": "string"
          },
          "toIswc": {
            "pattern": "T[0-9]{10}",
            "type": "string"
          },
          "fromIswc": {
            "pattern": "T[0-9]{10}",
            "type": "string"
          },
          "processingDate": {
            "type": "string",
            "format": "date-time"
          },
          "csnTransactionType": {
            "enum": [
              "MER",
              "DMR"
            ],
            "type": "string"
          },
          "workflowTaskId": {
            "type": "string"
          },
          "workflowStatus": {
            "title": "WorkflowStatus",
            "enum": [
              "Outstanding",
              "Approved",
              "Rejected",
              "Cancelled"
            ],
            "type": "string"
          },
          "receivingAgencyWorkCode": {
            "maxLength": 20,
            "type": "string"
          },
          "processedOnDate": {
            "type": "string",
            "format": "date-time"
          },
          "iswcMetadata": {
            "allOf": [
              {
                "properties": {
                  "createdDate": {
                    "type": "string",
                    "description": "Data and time of creation in the system",
                    "format": "date-time"
                  },
                  "lastModifiedDate": {
                    "type": "string",
                    "description": "Data and time of the latest update in the system",
                    "format": "date-time"
                  },
                  "lastModifiedBy": {
                    "type": "string",
                    "description": "Identifier of the last update in the system"
                  }
                }
              },
              {
                "required": [
                  "originalTitle",
                  "interestedParties"
                ],
                "properties": {
                  "iswc": {
                    "pattern": "T[0-9]{10}",
                    "type": "string"
                  },
                  "agency": {
                    "maxLength": 3,
                    "minLength": 3,
                    "type": "string",
                    "description": "A CISAC code of a submitting agency that allocated this ISWC"
                  },
                  "originalTitle": {
                    "type": "string",
                    "description": "Original title of a musical composition"
                  },
                  "otherTitles": {
                    "type": "array",
                    "items": {
                      "required": [
                        "title",
                        "type"
                      ],
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string",
                          "description": "Musical work title"
                        },
                        "type": {
                          "enum": [
                            "CT",
                            "OT",
                            "RT",
                            "AT",
                            "ET",
                            "ST",
                            "TO",
                            "OA",
                            "TE",
                            "FT",
                            "IT",
                            "TT",
                            "PT",
                            "OL",
                            "AL"
                          ],
                          "type": "string",
                          "description": "Musical work title type"
                        }
                      }
                    },
                    "description": "Other titles associated with musical composition (aka alternative titles)"
                  },
                  "interestedParties": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "lastName": {
                          "type": "string"
                        },
                        "nameNumber": {
                          "type": "integer",
                          "format": "int64"
                        },
                        "baseNumber": {
                          "type": "string"
                        },
                        "affiliation": {
                          "type": "string"
                        },
                        "role": {
                          "enum": [
                            "CA",
                            "AR",
                            "SE",
                            "PA",
                            "ES",
                            "AM",
                            "SA",
                            "C",
                            "AD",
                            "A",
                            "E",
                            "AQ",
                            "SR",
                            "TR",
                            "MA",
                            "TA"
                          ],
                          "type": "string",
                          "description": "The role will be rolled up to the corresponding CISAC Role as per the following mapping: C(C,A,CA), MA(AR,SR), TA(AD,SA,TR) E(E,AM)"
                        },
                        "legalEntityType": {
                          "enum": [
                            "N",
                            "L"
                          ],
                          "type": "string"
                        }
                      }
                    },
                    "description": "Interested party associated with musical composition, such as :composers, lyricist, translator, original and sub publishers"
                  }
                }
              },
              {
                "required": [
                  "iswc",
                  "agency"
                ],
                "type": "object",
                "properties": {
                  "works": {
                    "type": "array",
                    "items": {
                      "required": [
                        "id",
                        "iswc",
                        "deleted"
                      ],
                      "allOf": [
                        {
                          "required": [
                            "agency",
                            "sourcedb",
                            "workcode",
                            "category",
                            "originalTitle",
                            "interestedParties"
                          ],
                          "allOf": [
                            {
                              "required": [
                                "originalTitle",
                                "interestedParties"
                              ],
                              "properties": {
                                "iswc": {
                                  "pattern": "T[0-9]{10}",
                                  "type": "string"
                                },
                                "agency": {
                                  "maxLength": 3,
                                  "minLength": 3,
                                  "type": "string",
                                  "description": "A CISAC code of a submitting agency that allocated this ISWC"
                                },
                                "originalTitle": {
                                  "type": "string",
                                  "description": "Original title of a musical composition"
                                },
                                "otherTitles": {
                                  "type": "array",
                                  "items": {
                                    "required": [
                                      "title",
                                      "type"
                                    ],
                                    "type": "object",
                                    "properties": {
                                      "title": {
                                        "type": "string",
                                        "description": "Musical work title"
                                      },
                                      "type": {
                                        "enum": [
                                          "CT",
                                          "OT",
                                          "RT",
                                          "AT",
                                          "ET",
                                          "ST",
                                          "TO",
                                          "OA",
                                          "TE",
                                          "FT",
                                          "IT",
                                          "TT",
                                          "PT",
                                          "OL",
                                          "AL"
                                        ],
                                        "type": "string",
                                        "description": "Musical work title type"
                                      }
                                    }
                                  },
                                  "description": "Other titles associated with musical composition (aka alternative titles)"
                                },
                                "interestedParties": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "name": {
                                        "type": "string"
                                      },
                                      "lastName": {
                                        "type": "string"
                                      },
                                      "nameNumber": {
                                        "type": "integer",
                                        "format": "int64"
                                      },
                                      "baseNumber": {
                                        "type": "string"
                                      },
                                      "affiliation": {
                                        "type": "string"
                                      },
                                      "role": {
                                        "enum": [
                                          "CA",
                                          "AR",
                                          "SE",
                                          "PA",
                                          "ES",
                                          "AM",
                                          "SA",
                                          "C",
                                          "AD",
                                          "A",
                                          "E",
                                          "AQ",
                                          "SR",
                                          "TR",
                                          "MA",
                                          "TA"
                                        ],
                                        "type": "string",
                                        "description": "The role will be rolled up to the corresponding CISAC Role as per the following mapping: C(C,A,CA), MA(AR,SR), TA(AD,SA,TR) E(E,AM)"
                                      },
                                      "legalEntityType": {
                                        "enum": [
                                          "N",
                                          "L"
                                        ],
                                        "type": "string"
                                      }
                                    }
                                  },
                                  "description": "Interested party associated with musical composition, such as :composers, lyricist, translator, original and sub publishers"
                                }
                              }
                            },
                            {
                              "type": "object"
                            }
                          ],
                          "properties": {
                            "agency": {
                              "maxLength": 3,
                              "minLength": 3,
                              "type": "string"
                            },
                            "sourcedb": {
                              "type": "integer",
                              "format": "int32"
                            },
                            "workcode": {
                              "type": "string"
                            },
                            "category": {
                              "enum": [
                                "DOM",
                                "INT"
                              ],
                              "type": "string"
                            },
                            "disambiguation": {
                              "type": "boolean"
                            },
                            "disambiguationReason": {
                              "enum": [
                                "DIT",
                                "DIA",
                                "DIE",
                                "DIC",
                                "DIP",
                                "DIV"
                              ],
                              "type": "string",
                              "description": "Disambiguation Reason Code"
                            },
                            "disambiguateFrom": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "iswc": {
                                    "pattern": "T[0-9]{10}",
                                    "type": "string"
                                  }
                                }
                              }
                            },
                            "bvltr": {
                              "enum": [
                                "Background",
                                "Logo",
                                "Theme",
                                "Visual",
                                "RolledUpCue"
                              ],
                              "type": "string",
                              "description": "Background, Logo, Theme, Visual or Rolled Up Cue"
                            },
                            "derivedWorkType": {
                              "enum": [
                                "ModifiedVersion",
                                "Excerpt",
                                "Composite"
                              ],
                              "type": "string",
                              "description": "Derived Work Type- if not provided then this isn't a derived work"
                            },
                            "derivedFromIswcs": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "iswc": {
                                    "pattern": "T[0-9]{10}",
                                    "type": "string"
                                  },
                                  "title": {
                                    "type": "string"
                                  }
                                }
                              }
                            },
                            "performers": {
                              "type": "array",
                              "items": {
                                "required": [
                                  "lastName"
                                ],
                                "type": "object",
                                "properties": {
                                  "firstName": {
                                    "maxLength": 50,
                                    "minLength": 1,
                                    "type": "string"
                                  },
                                  "lastName": {
                                    "maxLength": 50,
                                    "minLength": 1,
                                    "type": "string"
                                  }
                                }
                              }
                            },
                            "instrumentation": {
                              "type": "array",
                              "items": {
                                "required": [
                                  "code"
                                ],
                                "type": "object",
                                "properties": {
                                  "code": {
                                    "maxLength": 3,
                                    "minLength": 1,
                                    "type": "string"
                                  }
                                }
                              }
                            },
                            "cisnetCreatedDate": {
                              "type": "string",
                              "description": "Date and time when this metadata was created on CISNET",
                              "format": "date-time"
                            },
                            "cisnetLastModifiedDate": {
                              "type": "string",
                              "description": "Date and time when this metadata last modified on CISNET",
                              "format": "date-time"
                            },
                            "additionalIdentifiers": {
                              "type": "object",
                              "properties": {
                                "isrcs": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "publisherIdentifiers": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "nameNumber": {
                                        "type": "integer",
                                        "format": "int64"
                                      },
                                      "submitterCode": {
                                        "type": "string"
                                      },
                                      "workCode": {
                                        "type": "array",
                                        "items": {
                                          "type": "string"
                                        }
                                      }
                                    }
                                  }
                                },
                                "agencyWorkCodes": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "agency": {
                                        "maxLength": 3,
                                        "minLength": 3,
                                        "type": "string"
                                      },
                                      "workCode": {
                                        "maxLength": 20,
                                        "type": "string"
                                      }
                                    }
                                  }
                                }
                              },
                              "description": "Optional list of additional identifiers that can be supplied with the submission."
                            }
                          }
                        },
                        {
                          "properties": {
                            "createdDate": {
                              "type": "string",
                              "description": "Data and time of creation in the system",
                              "format": "date-time"
                            },
                            "lastModifiedDate": {
                              "type": "string",
                              "description": "Data and time of the latest update in the system",
                              "format": "date-time"
                            },
                            "lastModifiedBy": {
                              "type": "string",
                              "description": "Identifier of the last update in the system"
                            }
                          }
                        },
                        {
                          "type": "object"
                        }
                      ],
                      "properties": {
                        "id": {
                          "type": "integer",
                          "description": "An unique identifier assigned by the system",
                          "format": "int64"
                        },
                        "iswc": {
                          "description": "A preferred ISWC assigned by the system"
                        },
                        "iswcEligible": {
                          "type": "boolean",
                          "description": "Indicator of a submitter being Iswc Eligible"
                        },
                        "deleted": {
                          "type": "boolean",
                          "description": "Indicator of a submission being logically deleted on CSINET"
                        },
                        "linkedFrom": {
                          "pattern": "T[0-9]{10}",
                          "type": "string",
                          "description": "The ISWC record that this is linked from"
                        },
                        "linkedTo": {
                          "pattern": "T[0-9]{10}",
                          "type": "string",
                          "description": "The ISWC record that this is linked to"
                        },
                        "rejection": {
                          "required": [
                            "code",
                            "message"
                          ],
                          "properties": {
                            "code": {
                              "type": "string"
                            },
                            "message": {
                              "type": "string"
                            }
                          }
                        },
                        "archivedIswc": {
                          "pattern": "T[0-9]{10}",
                          "type": "string",
                          "description": "The Archived ISWC"
                        },
                        "overallParentISWC": {
                          "pattern": "T[0-9]{10}",
                          "type": "string",
                          "description": "The preferred ISWC that is at the top of the chain of ISWCs."
                        }
                      }
                    }
                  },
                  "parentISWC": {
                    "pattern": "T[0-9]{10}",
                    "type": "string",
                    "description": "A preferred ISWC of a parent of this ISWC. Presence of this field indicates that the ISWC merged to the parent."
                  },
                  "linkedISWC": {
                    "type": "array",
                    "items": {
                      "pattern": "T[0-9]{10}",
                      "type": "string"
                    },
                    "description": "All linked preferred ISWCs. Presence of this field indicates that those ISWCs merged to this ISWC."
                  },
                  "overallParentISWC": {
                    "pattern": "T[0-9]{10}",
                    "type": "string",
                    "description": "The preferred ISWC that is at the top of the chain of ISWCs."
                  }
                },
                "xml": {
                  "name": "ISWCMetadata"
                }
              }
            ]
          },
          "workflowMessage": {
            "type": "string"
          }
        }
      }
    },
    "continuationToken": {
      "type": "string"
    }
  }
}
<AgentNotificationResponse> <notifications> <submittingAgencyCode>string</submittingAgencyCode> <receivingAgencyCode>string</receivingAgencyCode> <toIswc>string</toIswc> <fromIswc>string</fromIswc> <processingDate>string</processingDate> <csnTransactionType>MER</csnTransactionType> <workflowTaskId>string</workflowTaskId> <workflowStatus>Outstanding</workflowStatus> <receivingAgencyWorkCode>string</receivingAgencyWorkCode> <processedOnDate>string</processedOnDate> <iswcMetadata> <createdDate>string</createdDate> <lastModifiedDate>string</lastModifiedDate> <lastModifiedBy>string</lastModifiedBy> <iswc>string</iswc> <agency>string</agency> <originalTitle>string</originalTitle> <otherTitles> <title>string</title> <type>CT</type> </otherTitles> <interestedParties> <name>string</name> <lastName>string</lastName> <nameNumber>0</nameNumber> <baseNumber>string</baseNumber> <affiliation>string</affiliation> <role>CA</role> <legalEntityType>N</legalEntityType> </interestedParties> <works> <id>0</id> <iswc /> <iswcEligible>true</iswcEligible> <deleted>true</deleted> <linkedFrom>string</linkedFrom> <linkedTo>string</linkedTo> <rejection> <code>string</code> <message>string</message> </rejection> <archivedIswc>string</archivedIswc> <overallParentISWC>string</overallParentISWC> <agency>string</agency> <sourcedb>0</sourcedb> <workcode>string</workcode> <category>DOM</category> <disambiguation>true</disambiguation> <disambiguationReason>DIT</disambiguationReason> <disambiguateFrom> <iswc>string</iswc> </disambiguateFrom> <bvltr>Background</bvltr> <derivedWorkType>ModifiedVersion</derivedWorkType> <derivedFromIswcs> <iswc>string</iswc> <title>string</title> </derivedFromIswcs> <performers> <firstName>string</firstName> <lastName>string</lastName> </performers> <instrumentation> <code>string</code> </instrumentation> <cisnetCreatedDate>string</cisnetCreatedDate> <cisnetLastModifiedDate>string</cisnetLastModifiedDate> <additionalIdentifiers> <isrcs>string</isrcs> <publisherIdentifiers> <nameNumber>0</nameNumber> <submitterCode>string</submitterCode> <workCode>string</workCode> </publisherIdentifiers> <agencyWorkCodes> <agency>string</agency> <workCode>string</workCode> </agencyWorkCodes> </additionalIdentifiers> <iswc>string</iswc> <agency>string</agency> <originalTitle>string</originalTitle> <otherTitles> <title>string</title> <type>CT</type> </otherTitles> <interestedParties> <name>string</name> <lastName>string</lastName> <nameNumber>0</nameNumber> <baseNumber>string</baseNumber> <affiliation>string</affiliation> <role>CA</role> <legalEntityType>N</legalEntityType> </interestedParties> <createdDate>string</createdDate> <lastModifiedDate>string</lastModifiedDate> <lastModifiedBy>string</lastModifiedBy> </works> <parentISWC>string</parentISWC> <linkedISWC>string</linkedISWC> <overallParentISWC>string</overallParentISWC> </iswcMetadata> <workflowMessage>string</workflowMessage> </notifications> <continuationToken>string</continuationToken> </AgentNotificationResponse>
{
  "type": "object",
  "properties": {
    "notifications": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "submittingAgencyCode": {
            "maxLength": 3,
            "minLength": 3,
            "type": "string"
          },
          "receivingAgencyCode": {
            "maxLength": 3,
            "minLength": 3,
            "type": "string"
          },
          "toIswc": {
            "pattern": "T[0-9]{10}",
            "type": "string"
          },
          "fromIswc": {
            "pattern": "T[0-9]{10}",
            "type": "string"
          },
          "processingDate": {
            "type": "string",
            "format": "date-time"
          },
          "csnTransactionType": {
            "enum": [
              "MER",
              "DMR"
            ],
            "type": "string"
          },
          "workflowTaskId": {
            "type": "string"
          },
          "workflowStatus": {
            "title": "WorkflowStatus",
            "enum": [
              "Outstanding",
              "Approved",
              "Rejected",
              "Cancelled"
            ],
            "type": "string"
          },
          "receivingAgencyWorkCode": {
            "maxLength": 20,
            "type": "string"
          },
          "processedOnDate": {
            "type": "string",
            "format": "date-time"
          },
          "iswcMetadata": {
            "allOf": [
              {
                "properties": {
                  "createdDate": {
                    "type": "string",
                    "description": "Data and time of creation in the system",
                    "format": "date-time"
                  },
                  "lastModifiedDate": {
                    "type": "string",
                    "description": "Data and time of the latest update in the system",
                    "format": "date-time"
                  },
                  "lastModifiedBy": {
                    "type": "string",
                    "description": "Identifier of the last update in the system"
                  }
                }
              },
              {
                "required": [
                  "originalTitle",
                  "interestedParties"
                ],
                "properties": {
                  "iswc": {
                    "pattern": "T[0-9]{10}",
                    "type": "string"
                  },
                  "agency": {
                    "maxLength": 3,
                    "minLength": 3,
                    "type": "string",
                    "description": "A CISAC code of a submitting agency that allocated this ISWC"
                  },
                  "originalTitle": {
                    "type": "string",
                    "description": "Original title of a musical composition"
                  },
                  "otherTitles": {
                    "type": "array",
                    "items": {
                      "required": [
                        "title",
                        "type"
                      ],
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string",
                          "description": "Musical work title"
                        },
                        "type": {
                          "enum": [
                            "CT",
                            "OT",
                            "RT",
                            "AT",
                            "ET",
                            "ST",
                            "TO",
                            "OA",
                            "TE",
                            "FT",
                            "IT",
                            "TT",
                            "PT",
                            "OL",
                            "AL"
                          ],
                          "type": "string",
                          "description": "Musical work title type"
                        }
                      }
                    },
                    "description": "Other titles associated with musical composition (aka alternative titles)"
                  },
                  "interestedParties": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "lastName": {
                          "type": "string"
                        },
                        "nameNumber": {
                          "type": "integer",
                          "format": "int64"
                        },
                        "baseNumber": {
                          "type": "string"
                        },
                        "affiliation": {
                          "type": "string"
                        },
                        "role": {
                          "enum": [
                            "CA",
                            "AR",
                            "SE",
                            "PA",
                            "ES",
                            "AM",
                            "SA",
                            "C",
                            "AD",
                            "A",
                            "E",
                            "AQ",
                            "SR",
                            "TR",
                            "MA",
                            "TA"
                          ],
                          "type": "string",
                          "description": "The role will be rolled up to the corresponding CISAC Role as per the following mapping: C(C,A,CA), MA(AR,SR), TA(AD,SA,TR) E(E,AM)"
                        },
                        "legalEntityType": {
                          "enum": [
                            "N",
                            "L"
                          ],
                          "type": "string"
                        }
                      }
                    },
                    "description": "Interested party associated with musical composition, such as :composers, lyricist, translator, original and sub publishers"
                  }
                }
              },
              {
                "required": [
                  "iswc",
                  "agency"
                ],
                "type": "object",
                "properties": {
                  "works": {
                    "type": "array",
                    "items": {
                      "required": [
                        "id",
                        "iswc",
                        "deleted"
                      ],
                      "allOf": [
                        {
                          "required": [
                            "agency",
                            "sourcedb",
                            "workcode",
                            "category",
                            "originalTitle",
                            "interestedParties"
                          ],
                          "allOf": [
                            {
                              "required": [
                                "originalTitle",
                                "interestedParties"
                              ],
                              "properties": {
                                "iswc": {
                                  "pattern": "T[0-9]{10}",
                                  "type": "string"
                                },
                                "agency": {
                                  "maxLength": 3,
                                  "minLength": 3,
                                  "type": "string",
                                  "description": "A CISAC code of a submitting agency that allocated this ISWC"
                                },
                                "originalTitle": {
                                  "type": "string",
                                  "description": "Original title of a musical composition"
                                },
                                "otherTitles": {
                                  "type": "array",
                                  "items": {
                                    "required": [
                                      "title",
                                      "type"
                                    ],
                                    "type": "object",
                                    "properties": {
                                      "title": {
                                        "type": "string",
                                        "description": "Musical work title"
                                      },
                                      "type": {
                                        "enum": [
                                          "CT",
                                          "OT",
                                          "RT",
                                          "AT",
                                          "ET",
                                          "ST",
                                          "TO",
                                          "OA",
                                          "TE",
                                          "FT",
                                          "IT",
                                          "TT",
                                          "PT",
                                          "OL",
                                          "AL"
                                        ],
                                        "type": "string",
                                        "description": "Musical work title type"
                                      }
                                    }
                                  },
                                  "description": "Other titles associated with musical composition (aka alternative titles)"
                                },
                                "interestedParties": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "name": {
                                        "type": "string"
                                      },
                                      "lastName": {
                                        "type": "string"
                                      },
                                      "nameNumber": {
                                        "type": "integer",
                                        "format": "int64"
                                      },
                                      "baseNumber": {
                                        "type": "string"
                                      },
                                      "affiliation": {
                                        "type": "string"
                                      },
                                      "role": {
                                        "enum": [
                                          "CA",
                                          "AR",
                                          "SE",
                                          "PA",
                                          "ES",
                                          "AM",
                                          "SA",
                                          "C",
                                          "AD",
                                          "A",
                                          "E",
                                          "AQ",
                                          "SR",
                                          "TR",
                                          "MA",
                                          "TA"
                                        ],
                                        "type": "string",
                                        "description": "The role will be rolled up to the corresponding CISAC Role as per the following mapping: C(C,A,CA), MA(AR,SR), TA(AD,SA,TR) E(E,AM)"
                                      },
                                      "legalEntityType": {
                                        "enum": [
                                          "N",
                                          "L"
                                        ],
                                        "type": "string"
                                      }
                                    }
                                  },
                                  "description": "Interested party associated with musical composition, such as :composers, lyricist, translator, original and sub publishers"
                                }
                              }
                            },
                            {
                              "type": "object"
                            }
                          ],
                          "properties": {
                            "agency": {
                              "maxLength": 3,
                              "minLength": 3,
                              "type": "string"
                            },
                            "sourcedb": {
                              "type": "integer",
                              "format": "int32"
                            },
                            "workcode": {
                              "type": "string"
                            },
                            "category": {
                              "enum": [
                                "DOM",
                                "INT"
                              ],
                              "type": "string"
                            },
                            "disambiguation": {
                              "type": "boolean"
                            },
                            "disambiguationReason": {
                              "enum": [
                                "DIT",
                                "DIA",
                                "DIE",
                                "DIC",
                                "DIP",
                                "DIV"
                              ],
                              "type": "string",
                              "description": "Disambiguation Reason Code"
                            },
                            "disambiguateFrom": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "iswc": {
                                    "pattern": "T[0-9]{10}",
                                    "type": "string"
                                  }
                                }
                              }
                            },
                            "bvltr": {
                              "enum": [
                                "Background",
                                "Logo",
                                "Theme",
                                "Visual",
                                "RolledUpCue"
                              ],
                              "type": "string",
                              "description": "Background, Logo, Theme, Visual or Rolled Up Cue"
                            },
                            "derivedWorkType": {
                              "enum": [
                                "ModifiedVersion",
                                "Excerpt",
                                "Composite"
                              ],
                              "type": "string",
                              "description": "Derived Work Type- if not provided then this isn't a derived work"
                            },
                            "derivedFromIswcs": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "iswc": {
                                    "pattern": "T[0-9]{10}",
                                    "type": "string"
                                  },
                                  "title": {
                                    "type": "string"
                                  }
                                }
                              }
                            },
                            "performers": {
                              "type": "array",
                              "items": {
                                "required": [
                                  "lastName"
                                ],
                                "type": "object",
                                "properties": {
                                  "firstName": {
                                    "maxLength": 50,
                                    "minLength": 1,
                                    "type": "string"
                                  },
                                  "lastName": {
                                    "maxLength": 50,
                                    "minLength": 1,
                                    "type": "string"
                                  }
                                }
                              }
                            },
                            "instrumentation": {
                              "type": "array",
                              "items": {
                                "required": [
                                  "code"
                                ],
                                "type": "object",
                                "properties": {
                                  "code": {
                                    "maxLength": 3,
                                    "minLength": 1,
                                    "type": "string"
                                  }
                                }
                              }
                            },
                            "cisnetCreatedDate": {
                              "type": "string",
                              "description": "Date and time when this metadata was created on CISNET",
                              "format": "date-time"
                            },
                            "cisnetLastModifiedDate": {
                              "type": "string",
                              "description": "Date and time when this metadata last modified on CISNET",
                              "format": "date-time"
                            },
                            "additionalIdentifiers": {
                              "type": "object",
                              "properties": {
                                "isrcs": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                },
                                "publisherIdentifiers": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "nameNumber": {
                                        "type": "integer",
                                        "format": "int64"
                                      },
                                      "submitterCode": {
                                        "type": "string"
                                      },
                                      "workCode": {
                                        "type": "array",
                                        "items": {
                                          "type": "string"
                                        }
                                      }
                                    }
                                  }
                                },
                                "agencyWorkCodes": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "agency": {
                                        "maxLength": 3,
                                        "minLength": 3,
                                        "type": "string"
                                      },
                                      "workCode": {
                                        "maxLength": 20,
                                        "type": "string"
                                      }
                                    }
                                  }
                                }
                              },
                              "description": "Optional list of additional identifiers that can be supplied with the submission."
                            }
                          }
                        },
                        {
                          "properties": {
                            "createdDate": {
                              "type": "string",
                              "description": "Data and time of creation in the system",
                              "format": "date-time"
                            },
                            "lastModifiedDate": {
                              "type": "string",
                              "description": "Data and time of the latest update in the system",
                              "format": "date-time"
                            },
                            "lastModifiedBy": {
                              "type": "string",
                              "description": "Identifier of the last update in the system"
                            }
                          }
                        },
                        {
                          "type": "object"
                        }
                      ],
                      "properties": {
                        "id": {
                          "type": "integer",
                          "description": "An unique identifier assigned by the system",
                          "format": "int64"
                        },
                        "iswc": {
                          "description": "A preferred ISWC assigned by the system"
                        },
                        "iswcEligible": {
                          "type": "boolean",
                          "description": "Indicator of a submitter being Iswc Eligible"
                        },
                        "deleted": {
                          "type": "boolean",
                          "description": "Indicator of a submission being logically deleted on CSINET"
                        },
                        "linkedFrom": {
                          "pattern": "T[0-9]{10}",
                          "type": "string",
                          "description": "The ISWC record that this is linked from"
                        },
                        "linkedTo": {
                          "pattern": "T[0-9]{10}",
                          "type": "string",
                          "description": "The ISWC record that this is linked to"
                        },
                        "rejection": {
                          "required": [
                            "code",
                            "message"
                          ],
                          "properties": {
                            "code": {
                              "type": "string"
                            },
                            "message": {
                              "type": "string"
                            }
                          }
                        },
                        "archivedIswc": {
                          "pattern": "T[0-9]{10}",
                          "type": "string",
                          "description": "The Archived ISWC"
                        },
                        "overallParentISWC": {
                          "pattern": "T[0-9]{10}",
                          "type": "string",
                          "description": "The preferred ISWC that is at the top of the chain of ISWCs."
                        }
                      }
                    }
                  },
                  "parentISWC": {
                    "pattern": "T[0-9]{10}",
                    "type": "string",
                    "description": "A preferred ISWC of a parent of this ISWC. Presence of this field indicates that the ISWC merged to the parent."
                  },
                  "linkedISWC": {
                    "type": "array",
                    "items": {
                      "pattern": "T[0-9]{10}",
                      "type": "string"
                    },
                    "description": "All linked preferred ISWCs. Presence of this field indicates that those ISWCs merged to this ISWC."
                  },
                  "overallParentISWC": {
                    "pattern": "T[0-9]{10}",
                    "type": "string",
                    "description": "The preferred ISWC that is at the top of the chain of ISWCs."
                  }
                },
                "xml": {
                  "name": "ISWCMetadata"
                }
              }
            ]
          },
          "workflowMessage": {
            "type": "string"
          }
        }
      }
    },
    "continuationToken": {
      "type": "string"
    }
  }
}

400 Bad Request

Bad Request

401 Unauthorized

Not Authorized

Code samples

@ECHO OFF

curl -v -X GET "https://cisaciswcuat.azure-api.net/agent/notification?agency={agency}&csnTransactionType={csnTransactionType}&fromDate={fromDate}&pageLength={pageLength}?continuationToken={string}"
-H "Ocp-Apim-Subscription-Key: {subscription key}"

--data-ascii "{body}" 
using System;
using System.Net.Http.Headers;
using System.Text;
using System.Net.Http;
using System.Web;

namespace CSHttpClientSample
{
    static class Program
    {
        static void Main()
        {
            MakeRequest();
            Console.WriteLine("Hit ENTER to exit...");
            Console.ReadLine();
        }
        
        static async void MakeRequest()
        {
            var client = new HttpClient();
            var queryString = HttpUtility.ParseQueryString(string.Empty);

            // Request headers
            client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", "{subscription key}");

            // Request parameters
            queryString["continuationToken"] = "{string}";
            var uri = "https://cisaciswcuat.azure-api.net/agent/notification?agency={agency}&csnTransactionType={csnTransactionType}&fromDate={fromDate}&pageLength={pageLength}&" + queryString;

            var response = await client.GetAsync(uri);
        }
    }
}	
// // This sample uses the Apache HTTP client from HTTP Components (http://hc.apache.org/httpcomponents-client-ga/)
import java.net.URI;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.utils.URIBuilder;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class JavaSample 
{
    public static void main(String[] args) 
    {
        HttpClient httpclient = HttpClients.createDefault();

        try
        {
            URIBuilder builder = new URIBuilder("https://cisaciswcuat.azure-api.net/agent/notification?agency={agency}&csnTransactionType={csnTransactionType}&fromDate={fromDate}&pageLength={pageLength}");

            builder.setParameter("continuationToken", "{string}");

            URI uri = builder.build();
            HttpGet request = new HttpGet(uri);
            request.setHeader("Ocp-Apim-Subscription-Key", "{subscription key}");


            // Request body
            StringEntity reqEntity = new StringEntity("{body}");
            request.setEntity(reqEntity);

            HttpResponse response = httpclient.execute(request);
            HttpEntity entity = response.getEntity();

            if (entity != null) 
            {
                System.out.println(EntityUtils.toString(entity));
            }
        }
        catch (Exception e)
        {
            System.out.println(e.getMessage());
        }
    }
}

<!DOCTYPE html>
<html>
<head>
    <title>JSSample</title>
    <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.9.0/jquery.min.js"></script>
</head>
<body>

<script type="text/javascript">
    $(function() {
        var params = {
            // Request parameters
            "continuationToken": "{string}",
        };
      
        $.ajax({
            url: "https://cisaciswcuat.azure-api.net/agent/notification?agency={agency}&csnTransactionType={csnTransactionType}&fromDate={fromDate}&pageLength={pageLength}&" + $.param(params),
            beforeSend: function(xhrObj){
                // Request headers
                xhrObj.setRequestHeader("Ocp-Apim-Subscription-Key","{subscription key}");
            },
            type: "GET",
            // Request body
            data: "{body}",
        })
        .done(function(data) {
            alert("success");
        })
        .fail(function() {
            alert("error");
        });
    });
</script>
</body>
</html>
#import <Foundation/Foundation.h>

int main(int argc, const char * argv[])
{
    NSAutoreleasePool * pool = [[NSAutoreleasePool alloc] init];
    
    NSString* path = @"https://cisaciswcuat.azure-api.net/agent/notification?agency={agency}&csnTransactionType={csnTransactionType}&fromDate={fromDate}&pageLength={pageLength}";
    NSArray* array = @[
                         // Request parameters
                         @"entities=true",
                         @"continuationToken={string}",
                      ];
    
    NSString* string = [array componentsJoinedByString:@"&"];
    path = [path stringByAppendingFormat:@"?%@", string];

    NSLog(@"%@", path);

    NSMutableURLRequest* _request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:path]];
    [_request setHTTPMethod:@"GET"];
    // Request headers
    [_request setValue:@"{subscription key}" forHTTPHeaderField:@"Ocp-Apim-Subscription-Key"];
    // Request body
    [_request setHTTPBody:[@"{body}" dataUsingEncoding:NSUTF8StringEncoding]];
    
    NSURLResponse *response = nil;
    NSError *error = nil;
    NSData* _connectionData = [NSURLConnection sendSynchronousRequest:_request returningResponse:&response error:&error];

    if (nil != error)
    {
        NSLog(@"Error: %@", error);
    }
    else
    {
        NSError* error = nil;
        NSMutableDictionary* json = nil;
        NSString* dataString = [[NSString alloc] initWithData:_connectionData encoding:NSUTF8StringEncoding];
        NSLog(@"%@", dataString);
        
        if (nil != _connectionData)
        {
            json = [NSJSONSerialization JSONObjectWithData:_connectionData options:NSJSONReadingMutableContainers error:&error];
        }
        
        if (error || !json)
        {
            NSLog(@"Could not parse loaded json with error:%@", error);
        }
        
        NSLog(@"%@", json);
        _connectionData = nil;
    }
    
    [pool drain];

    return 0;
}
<?php
// This sample uses the Apache HTTP client from HTTP Components (http://hc.apache.org/httpcomponents-client-ga/)
require_once 'HTTP/Request2.php';

$request = new Http_Request2('https://cisaciswcuat.azure-api.net/agent/notification?agency={agency}&csnTransactionType={csnTransactionType}&fromDate={fromDate}&pageLength={pageLength}');
$url = $request->getUrl();

$headers = array(
    // Request headers
    'Ocp-Apim-Subscription-Key' => '{subscription key}',
);

$request->setHeader($headers);

$parameters = array(
    // Request parameters
    'continuationToken' => '{string}',
);

$url->setQueryVariables($parameters);

$request->setMethod(HTTP_Request2::METHOD_GET);

// Request body
$request->setBody("{body}");

try
{
    $response = $request->send();
    echo $response->getBody();
}
catch (HttpException $ex)
{
    echo $ex;
}

?>
########### Python 2.7 #############
import httplib, urllib, base64

headers = {
    # Request headers
    'Ocp-Apim-Subscription-Key': '{subscription key}',
}

params = urllib.urlencode({
    # Request parameters
    'continuationToken': '{string}',
})

try:
    conn = httplib.HTTPSConnection('cisaciswcuat.azure-api.net')
    conn.request("GET", "/agent/notification?agency={agency}&csnTransactionType={csnTransactionType}&fromDate={fromDate}&pageLength={pageLength}&%s" % params, "{body}", headers)
    response = conn.getresponse()
    data = response.read()
    print(data)
    conn.close()
except Exception as e:
    print("[Errno {0}] {1}".format(e.errno, e.strerror))

####################################

########### Python 3.2 #############
import http.client, urllib.request, urllib.parse, urllib.error, base64

headers = {
    # Request headers
    'Ocp-Apim-Subscription-Key': '{subscription key}',
}

params = urllib.parse.urlencode({
    # Request parameters
    'continuationToken': '{string}',
})

try:
    conn = http.client.HTTPSConnection('cisaciswcuat.azure-api.net')
    conn.request("GET", "/agent/notification?agency={agency}&csnTransactionType={csnTransactionType}&fromDate={fromDate}&pageLength={pageLength}&%s" % params, "{body}", headers)
    response = conn.getresponse()
    data = response.read()
    print(data)
    conn.close()
except Exception as e:
    print("[Errno {0}] {1}".format(e.errno, e.strerror))

####################################
require 'net/http'

uri = URI('https://cisaciswcuat.azure-api.net/agent/notification?agency={agency}&csnTransactionType={csnTransactionType}&fromDate={fromDate}&pageLength={pageLength}')

query = URI.encode_www_form({
    # Request parameters
    'continuationToken' => '{string}'
})
if query.length > 0
  if uri.query && uri.query.length > 0
    uri.query += '&' + query
  else
    uri.query = query
  end
end

request = Net::HTTP::Get.new(uri.request_uri)
# Request headers
request['Ocp-Apim-Subscription-Key'] = '{subscription key}'
# Request body
request.body = "{body}"

response = Net::HTTP.start(uri.host, uri.port, :use_ssl => uri.scheme == 'https') do |http|
    http.request(request)
end

puts response.body