GetCollaborations

Get Collaborations

Allows to retrieve Collaborations. This endpoint supports pagination and filtering. This operation is only allowed when the requestor is the Collaboration owner.

Request

URLs: /v1/collaborations

Method: GET

Path Parameters: None

Query Parameters:

Parameter	Type	Description	Requirement Type
offset	integer	Start offset of paginated results to retrieve. Default is 0.	Optional
limit	integer	Maximum number of paginated results to retrieve. Default is 25.	Optional
ids	string list	Comma-separated list of Collaboration UUID's to filter-out results. If missing, defaults to no filtering out.	Optional
songIds	string list	Comma-separated list of Song UUID's to filter-out results.	Optional
emails	string list	Comma-separated list of email addresses of Collaborators to filter-out results.	Optional
olderThan	string	ISO-8601 formated oldest (maximum) timestamp to filter-out results. If missing, defaults to no filtering out.	Optional
newerThan	string	ISO-8601 formated newest (minimum) timestamp to filter-out results. If missing, defaults to no filtering out.	Optional

Headers:

Authorization: Bearer {accessToken}

Accept: application/json

✅ Success Response

Code: 200 OK

Headers:

Content-Type: application/json

Content:

Field	Type	Description	Condition
id	string	UUID of the Collaboration.	Always
createdAt	string	Date and time when the Collaboration was created (ISO-8601 format).	Always
songId	string	UUID of the underying Song.	Always
email	string	Email of the Collaborator.	Always
role	string	Collaborator role.	Only if available
royaltyRate	decimal	Percentage of total royalties owned to the Collaborator.	Only if available
credited	boolean	Indicates whether or not the Collaboration has been credited to the Collaborator.	Always
accepted	boolean	Indicates whether or not the Collaboration has been accepted by the Collaborator.	Always

Content example:

[
    {
        "id": "7bd2862f-8deb-4814-8943-156d9dab80dd",
        "createdAt": "2022-04-22T20:47:55.738918",
        "songId": "842f5460-76f8-41d8-add9-d043a7a381de",
        "email": "[email protected]",
        "role": "Composer",
        "royaltyRate": 10.5,
        "credited": true,
        "accepted": false
    },
    {
        "id": "5cd11788-4cc1-4768-b4fa-4c0f519a94c5",
        "ownerId": "842f5460-76f8-41d8-add9-d043a7a381de",
        "createdAt": "2022-05-22T20:46:46.738741",
        "songId": "842f5460-76f8-41d8-add9-d043a7a381de",
        "email": "[email protected]",
        "role": "Backup Singer",
        "royaltyRate": 3.1,
        "credited": false,
        "accepted": true
    }
]

❌ Error Responses

1. Unauthorized

Code: 401 UNAUTHORIZED

Condition: If {accessToken} is invalid or expired.

2. Unprocessable Entity

Code: 422 UNPROCESSABLE ENTITY

Condition: If any of the UUID query parameters is malformed.

Headers:

Content-Type: application/json

Content example:

{
    "code": 422,
    "description": "Unprocessable Entity",
    "cause": "Invalid UUID string: 123456789"
}

See Also

Post Collaboration (Add New Collaboration)

Patch Collaboration (Update Collaboration)

Get Collaboration

Get Collaboration Count

Delete Collaboration

Get Collaborators

Get Collaborator Count