Skip to main content
GET
/
releases
/
stats
Get Release Statistics
curl --request GET \
  --url https://api.royalti.io/releases/stats \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "total": 123,
    "totalPublished": 123,
    "totalDrafts": 123,
    "totalRejected": 123,
    "totalPending": 123,
    "totalScheduled": 123,
    "mainGenre": [
      "Pop"
    ],
    "subGenre": [
      "Alternative R&B"
    ],
    "contributors": [
      {
        "role": "Producer",
        "name": "John Doe",
        "isni": "0000000123456789"
      }
    ],
    "metadata": {},
    "explicit": null
  }
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Description

This endpoint retrieves comprehensive statistics about releases, including counts by status, format, type, and recent activity.

​
Code Examples

const response = await fetch('https://api.royalti.io/releases/stats', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}`,
  },
});

const data = await response.json();
console.log(data);

Authorizations

​
Authorization
string
header
required

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

Response

Success

​
success
boolean
Example:

true

​
data
object