From Safe Creative API
Jump to navigation Jump to search

Returns a list of the copyright holders of a work.

'Shared works management' professional service must be active for the authorizing user.


  • Component name: work.rightsholders.list
  • Signature: Requires signature using the authorization key's private key
  • Timestamp: ZTime is not required
  • Authorization level: GET
  • API trust level: Standard


  • authkey*: Authorization key
  • workcode*: Work code

* Required parameter


  • rightsholders
    • rightsholder
      • usercode: Copyright holder's Safe Creative code
      • name: Full name, pseudonym or mail address (if not confirmed yet)
      • can-edit: Can edit the work (true|false)
      • state: Rights sharing state. One of the following:
        • PENDING: A rights sharing request has been sent, but it has not been answered
        • ACTIVE: This rights sharing has been confirmed
        • REJECTED: This rights sharing request has been rejected by the recipient
        • INACTIVE: This rights sharing has been cancelled
        • INVALID: This rights sharing has been deemed invalid (e.g. recipient was already a copyright holder of the work)
      • entrydate: Date of acceptance of rights holding
      • roles: List of roles of this copyright holder
        • role: One of AUTHOR, RIGHTS_HOLDER, INFORMER
      • pending-request: There is a pending request to this copyright holder
        • confirm-url: Confirmation URL sent with this request
        • request-usercode: Safe Creative code of the user who made this request
        • request-state: State to apply to this rights sharing if request is confirmed. Can be one of the following:
          • ACTIVE: It's a request for rights sharing
          • INACTIVE: It's a request to cancel the copyright holder rights
        • request-date: Date when this request was sent




<?xml version="1.0" encoding="UTF-8"?>
    <name>Sherlock Holmes</name>
    <name>John Watson</name>
    <name>John Watson</name>