---
title: "GET /royaltyTokens"
method: GET
path: "/royaltyTokens"
tags: ["royaltyTokens"]
---

# GET /royaltyTokens

`GET /royaltyTokens`

## Query parameters

- `pageNumber` integer
- `pageSize` integer
- `orderByProperty` string
- `orderByDescending` boolean
- `royaltyTokenStatus` string[]
- `fromDate` string, date-time
- `toDate` string, date-time
- `searchText` string
- `royaltyTokenIds` integer[]
- `assetIds` integer[]

## Response `200`

OK

- PagedListRoyaltyTokenDTO
  - `totalItemsCount` integer
  - `pageNumber` integer
  - `pageSize` integer
  - `items` RoyaltyTokenDTO[]
    - `royaltyTokenId` integer
    - `royaltyTokenAddress` string
    - `enterpriseId` integer
    - `createdBy` string, uuid
    - `createdAt` string, date-time
    - `assetType` 'track'
    - `assetId` integer
    - `assetMetadataJson` string
    - `originalHolders` RoyaltyTokenHolderDTO[]
      - `account` string
      - `friendlyName` string
      - `balance` string
      - `isAdmin` boolean
    - `holders` RoyaltyTokenHolderDTO[]
      - `account` string
      - `friendlyName` string
      - `balance` string
      - `isAdmin` boolean
    - `smartContractStandard` 'ERC20' | 'ERC1155'
    - `status` 'validationPending' | 'validationInProgress' | 'validationFailed' | 'sendCreationPending' | 'sendCreationInProgress' | 'sendCreationFailed' | 'checkCreationStatusPending' | 'checkCreationStatusInProgress' | 'checkCreationStatusFailed' | 'contractCreationPending' | 'contractCreationInProgress' | 'contractCreationFailed' | 'contractCreationCompleted'
    - `royaltyTokenURI` string
    - `network` string
    - `fees` string
    - `asset` OwnRestTokenFactSheetDTO
      - `type` string
      - `assetURI` string
      - `ownerURI` string
      - `artist` string
      - `name` string
      - `description` string
      - `bpm` integer
      - `duration` integer
      - `key` string
      - `genre` string
      - `image` string
      - `artistImageURL` string
      - `spotifyId` string
      - `appleId` integer
      - `trackMimeType` string
      - `artworkMimeType` string
      - `tags` string[]
      - `locationCreated` string
      - `external_url` OwnRestTokenFactSheetExternalUrlDTO[]
        - `name` string
        - `url` string
      - `animation_url` string
      - `youtube_url` string
      - `originalReleaseDate` string
      - `recordLabel` string
      - `publisher` string
      - `upc` string
      - `isrc` string
      - `lyrics` string
      - `language` string
      - `attributes` OwnRestTokenFactSheetAttributeDTO[]
        - `trait_type` string
        - `value` string
      - `credits` OwnRestTokenFactSheetCreditDTO[]
        - `name` string
        - `creditType` string
      - `releases` OwnRestTokenFactSheetReleaseDTO[]
        - `releaseType` string
        - `releaseTitle` string
        - `artist` string
        - `releaseDate` string
        - `recordLabel` string
        - `upc` number, double
        - `imageURL` string
      - `platform` OwnRestTokenFactSheetPlatformDTO
        - `name` string
        - `imageURL` string
        - `assetId` string
        - `enterpriseId` string
    - `assetName` string
    - `assetVersion` string
    - `payoutRate` number, double
  - `additionalCounters` object

---

[API](https://skmtc.net/revelator/apis/revelator-api.md) · [All operations](https://skmtc.net/revelator/apis/revelator-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/revelator/revelator-api/revisions/7a22c2db13c0/schema)