Writers

List Writers

Returns a paginated list of root writers for a project. Writers represent songwriters and composers extracted from contract documents.

Request

GET /v1/writers

Query Parameters

Parameter	Type	Required	Default	Description
`projectId`	UUID	Yes	—	The project to list writers for
`page`	integer	No	`1`	Page number (1-indexed)
`perPage`	integer	No	`20`	Items per page (1–100)
`includeMerged`	string	No	`false`	Set to `true` to include merged writers for each root writer

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <token>` — must be scoped to the requested project

Response

{
  "data": {
    "items": [
      {
        "id": "writer-1",
        "name": "Max Martin",
        "created_at": "2024-01-15T10:00:00Z",
        "merged": [
          { "id": "writer-2", "name": "Martin Sandberg", "merged_at": "2024-03-01T09:00:00Z" }
        ]
      }
    ],
    "total_count": 37,
    "page": 1,
    "per_page": 20
  }
}

The merged array only appears when includeMerged=true.

Errors

Status	Description
`400`	Missing `projectId` or invalid query parameters
`403`	Token is not scoped to the requested project

Example

curl "https://api.royaltyport.com/v1/writers?projectId=a1b2c3d4-...&page=1&perPage=50" \
  -H "Authorization: Bearer rp_your_token_here"

Get Writer

Returns a single writer by ID.

Request

GET /v1/writers/{writer_id}

Path Parameters

Parameter	Type	Required	Description
`writer_id`	string	Yes	The writer ID

Query Parameters

Parameter	Type	Required	Default	Description
`projectId`	UUID	Yes	—	The project the writer belongs to
`includeMerged`	string	No	`false`	Set to `true` to include merged writers

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <token>` — must be scoped to the requested project

Response

{
  "data": {
    "id": "writer-1",
    "name": "Max Martin",
    "created_at": "2024-01-15T10:00:00Z",
    "merged": [
      { "id": "writer-2", "name": "Martin Sandberg", "merged_at": "2024-03-01T09:00:00Z" }
    ]
  }
}

Errors

Status	Description
`400`	Missing `projectId`
`403`	Token is not scoped to the requested project
`404`	Writer not found

Example

curl "https://api.royaltyport.com/v1/writers/writer-1?projectId=a1b2c3d4-..." \
  -H "Authorization: Bearer rp_your_token_here"

Getting Started

REST API

List Writers

Request

Query Parameters

Headers

Response

Errors

Example

Get Writer

Request

Path Parameters

Query Parameters

Headers

Response

Errors

Example

​List Writers

​Request

​Query Parameters

​Headers

​Response

​Errors

​Example

​Get Writer

​Request

​Path Parameters

​Query Parameters

​Headers

​Response

​Errors

​Example

List Writers

Request

Query Parameters

Headers

Response

Errors

Example

Get Writer

Request

Path Parameters

Query Parameters

Headers

Response

Errors

Example