List works
GET /work/works
Description
GET /work/works Description: Lists the tenant’sCWRWork rows. Response is a BARE ARRAY (not an
envelope) — existing FE and cross-tenant consumers depend on that
shape. Each row is annotated with a computed writerCount and
publishingStatus. Supports free-text search/q (title, ISWC,
submitter work number), writerId scoping (only that writer’s
works, with the writer’s role surfaced per row), workType exact
filter, and registrationStatus facet (any WorkRegistration
status value, or unregistered for works with no registration row
at all). Optional page/size (default 20, capped at 100).
Authorization:
- Required role:
useror higher
Code Examples
Authorizations
JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"
Query Parameters
Matches workTitle, iswc, or submitterWorkNumber (case-insensitive). q is accepted as an alias.
pending, submitted, registered, rejected, conflict, cancelled, unregistered Response
Works retrieved
International Standard Musical Work Code (max 13 chars)
Seconds
CWR "recording detail" blocks embedded on the work (distinct from the WorkRecording junction table / WorkRecordings below)
Includes completeness (complete/skeleton), source (e.g. publishing-bootstrap), seededDefaults, origin.library
Derived, response-only publishing-readiness signal (WP-P4). Computed from CWRWork.metadata and the work's writer links — never persisted as a column.
Society registrations for the work (id, registrationStatus, societyCode, statusDate only)
Present only when the request is scoped with ?writerId= — that writer's role on this work