Skip to main content
GET
/
revenue
/
Get Revenues
curl --request GET \
  --url https://server26-dot-royalti-project.uc.r.appspot.com/revenue/ \
  --header 'Authorization: Bearer <token>'
{
  "message": "Revenues retrieved successfully",
  "revenues": [
    {
      "id": "revenue-uuid-123",
      "title": "Streaming Revenue - January 2024",
      "amount": 2500.5,
      "currency": "USD",
      "source": "streaming",
      "transactionDate": "2024-01-15T10:30:00Z",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 150,
  "page": 1,
  "size": 10,
  "totalPages": 15,
  "summary": {
    "totalAmount": 125000.75,
    "totalCount": 150,
    "byCurrency": {
      "USD": 100000.5,
      "EUR": 25000.25
    },
    "bySource": {
      "streaming": 80000.3,
      "sales": 30000.25,
      "licensing": 15000.2
    }
  }
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Code Examples

const response = await fetch('https://server26-dot-royalti-project.uc.r.appspot.com/revenue/', {
  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}"

Query Parameters

​
q
string

Search query to filter revenues

​
page
integer
default:1

Page number for pagination

​
size
integer
default:10

Number of revenues per page

​
sort
string
default:transactionDate

Field to sort by

​
order
enum<string>
default:desc

Sort order ('asc' or 'desc')

Available options:
asc,
desc
​
source
enum<string>

Filter by revenue source

Available options:
streaming,
sales,
licensing,
sync,
merchandise,
live_performance,
other
​
artist
string

Filter by artist ID

​
asset
string

Filter by asset ID

​
product
string

Filter by product ID

​
currency
string

Filter by currency

​
dateFrom
string<date>

Filter revenues from this date

​
dateTo
string<date>

Filter revenues to this date

​
include
string

Additional data to include (Artist, Asset, Product)

Response

Success

​
message
string
​
revenues
object[]
​
total
integer
​
page
integer
​
size
integer
​
totalPages
integer
​
summary
object