From Safe Creative API
Revision as of 08:07, 7 May 2021 by Adminwiki (talk | contribs) (4 revisions imported)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Returns a user's registered works list.


  • Component name: work.list
  • Signature: Requires signature using the authkey's private key
  • Timestamp: Requires ztime parameter
  • Authorization level: GET
  • API trust level: Standard


  • authkey*: User's authorization key
  • ztime*: Z-Timestamp
  • page: Page number
  • locale: Locale for work type, license names,...


The following parameters allow to filter the results:

  • state: Work state, as specified in About works
  • tag: Works with the specified tag
  • worktypeN: (multivalue) Codes of the work types to include in the results (as returned in work.types)
  • worktypegroup: Work type group code (as returned in work.types.tree)
  • license: License code (e.g. copyright)
  • fromdate: Works registered beginning on this date
  • todate: Works registered up to this date
  • filter: Text filter, returns works containing this text in their codes, titles, excerpts or tags


  • sortfield: Work list can be ordered by code(default) or title

* Required parameter


A paginated list of work elements:

  • work
    • code: Safe Creative work code
    • title: Work title
    • entrydate: Work registration date
    • state: Work state (see About works)




<?xml version="1.0" encoding="UTF-8"?>
      <title>Big times</title>