Skip to main content
GET
Get a writer, including associated works
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

GET /writer/writers/ Description: Fetches a single writer (with userData) plus every CWRWorkWriter association for that writer (each including its work), attached as workWriters on the response object. Supports ?export=csv. Authorization:
  • Required role: user or higher
Method: GET

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Path Parameters

id
string<uuid>
required

Query Parameters

export
enum<string>
Available options:
csv

Response

Writer retrieved

id
string<uuid>
tenantId
integer
firstName
string
lastName
string
ipiNameNumber
string | null

11-digit CISAC IPI name number. Unique per tenant when set.

ipiBaseNumber
string | null

13-character CISAC IPI base number. Unique per tenant when set.

writerRole
enum<string>

CWR writer designation code. One of: CA (Composer & Author), C (Composer), A (Author/Lyricist), AR (Arranger), AD (Adaptor), TR (Translator), SR (Sub-Arranger), LY (Lyricist), CO (Composer), PA (Performer).

Available options:
CA,
C,
A,
AR,
AD,
TR,
SR,
LY,
CO,
PA
affiliatedPRO
string | null

Performing rights organization the writer is affiliated with (e.g. ASCAP, BMI). Free text — not enum-validated.

mrSociety
string | null
Maximum string length: 3
srSociety
string | null
Maximum string length: 3
generallyControlled
boolean
default:false
canBeControlled
boolean
default:false
publisherFee
number | null
Required range: 0 <= x <= 100
saan
string | null

Society-Assigned Agreement Number.

Maximum string length: 14
territories
object[]

Defaults to a single worldwide (WW) entry at 100% PR/MR/SR if omitted on create.

settings
object

Free-form writer settings (e.g. defaultTerritory, defaultShares). Not accepted via the create/update request bodies — set separately or defaulted to {}.

tenantUserId
string<uuid> | null
userData
object

Linked TenantUser account, included when the writer has a tenantUserId.

createdAt
string<date-time>
updatedAt
string<date-time>
workWriters
object[]